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Preface 



This manual provides detailed information required by the person responsible for maintaining a 
990 computer system running under the DX10 operating system. 

This manual is one of a set of six volumes that describe the operational characteristics and 
features of DX10. In addition to the six volumes, several support manuals are available for DX10 
functions. Also each language supported by DX10 has its own associated manuals. 

Become acquainted with these volumes and related DX10 manuals as necessary to prepare and 
execute application programs under DX10. The following paragraphs each contain a brief 
comment regarding the content of each volume. (The full titles and part numbers of all manuals 
associated with the DX10 operating system are provided in the frontispiece.) The five associated 
volumes are as follows: 

Concepts and Facilities (Volume I) includes features, concepts, and general background 
information describing the DX10 operating system. It also contains a master subject index to help 
you find the information you need. 

The Operations Guide (Volume II) contains information on how to perform an initial program load 
(IPL start procedure) and how to log on and operate a terminal. Additionally, this manual contains 
an introduction to your interface with DX10, the System Command Interpreter (SCI), and includes a 
complete description of the SCI commands required to operate DX10. (The Text Editor and Link 
Editor commands are not included in Volume II, but can be found in their respective manuals. 
Debugger commands are in Volume III.) 

The Application Programming Guide (Volume III) contains information required by the application 
programmer to prepare, modify, and execute application programs on DX10. Much of the material 
is relevant to both high-level language programmers as well as assembly language programmers, 
since it concerns program structure, program operation, file structure, and file I/O. The SCI 
programming language is included, since it is a major part of constructing applications under 
DX10. Complete descriptions for nonprivileged supervisor calls (SVCs) and the DX10 Debugger are 
included for assembly language programs. 

The Text Editor Manual (Volume IV) includes operating instructions, examples, and exercises for 
the interactive Text Editor provided on DX10. The SCI commands and error messages related to 
the Text Editor are included. 

The Error Reporting and Recovery Manual (Volume VI) describes each error message you can 
receive while operating DX10 and gives suggested procedures for recovery. It documents task 
errors, command errors, SVC errors, SCI errors, and I/O errors including those from disk and 
magnetic tape. Also included are sections on system crash analysis and system troubleshooting. 
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Preface 



NOTE 

Additional, ih-depth descriptions related to specific languages, 
including FORTRAN, COBOL, BASIC, RPG II, Tl Pascal, assembly 
language, and Query are found in manuals dedicated to the appro- 
priate programming language. A Link Editor manual is provided as a 
separate volume that describes the application of the link edit func- 
tion in a DX10 environment. Separate manuals describe the use of 
optional Sort/Merge, DBMS, and CPG packages. 
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1.1 GENERAL INFORMATION 

This manual explains how to generate a customized DX10 operating system. You are presumed to 
be an experienced programmer with responsibility for maintaining and extending your operating 
system. This manual focuses on programming your operating system so that it runs most effi- 
ciently under general circumstances. Refer to DX10 Application Programming Guide (Volume III) 
for information about programming DX10 for specific applications. 

The DX10 operating system includes some standard functions and offers a set of optional 
functions that are hardware dependent. During system generation, you specify which functions to 
incorporate in your system. The standard functions include: 

• A multitasking, preemptive central processing unit (CPU) scheduler 

• An internal clock interrupt and timer 

• A supervisor call (SVC) preprocessor 

• Some task management SVC routines 

• Basic input/output (I/O) SVC routines 
Optional functions that require additional memory include: 

• Device support 

• Standard SVCs 

• Communications 

Much of the DX10 software resides on disk and is loaded into memory only when needed. Program 
swapping, file management, multiple dynamic job management, task loading, and numerous 
SVCs are required to operate the system. The system generation procedure allows you to include 
optional features such as support for multiple-user software development, key indexed files 
(KIFs), and remote I/O. 
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1.2 DISK BUILD PROCEDURE 

The DX10 software is shipped on several different media: assorted types of rigid disks, flexible 
diskettes, and magnetic tape. If your DX10 software arrives on disk, you can simply install the disk 
in the system disk drive and load the software immediately. However, if your system includes a 
DS10 or CD1400 disk drive, you may want to transfer the system software to the fixed disk. Also, if 
your software arrives on flexible diskette or magnetic tape, you must transfer it to disk. DX10 
includes a Disk Build utility to simplify this transferral. 

1.3 SYSTEM GENERATION 

Section 3 on system generation describes the base system configurations that DX10 supports and 
explains how to generate a logical configuration that reflects the physical configuration of your 
system. If you want to include extra devices or instructions, or exclude unnecessary features, you 
can customize your operating system during the process known as system generation. 

Customizing your operating system allows you to tailor it to fit specific application needs. During 
system generation, prompts appear on the screen of your video display terminal (VDT) that direct 
you to perform any of the following actions: 

Add or delete devices to the hardware configuration 

Include or exclude optional DX10 capabilities 

Include user-defined SVCs 

Generate specialized systems for specific programming environments, which can be 
used as operating conditions change 

Change various DX10 operating system parameters 

GEN990, the System Generation utility, interactively prompts you for information about the sys- 
tem to be built. After the interactive session, GEN990 builds the files necessary to complete sys- 
tem generation. You then direct a system utility to assemble and link the new or modified system. 
To complete system generation, you test the new system. If the new system contains errors, you 
can return control to the old system and repeat the system generation process. 

Section 4 explains how to handle errors that may occur during system generation. 

1.4 WRITING YOUR OWN DEVICE SERVICE ROUTINE (DSR) 

When you are quite familiar with programming for the DX10 operating system, you may decide to 
include nonstandard devices in the system. You must write a DSR to detect and service each non- 
standard device. During system generation, you integrate these DSRs with the supplied software. 
Section 5 describes how to write your own DSR and incorporate it in the system during system 
generation. 
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1.5 DESIGNING AND WRITING AN SVC PROCESSOR 

You can write new SVCs and SVC processing routines to provide services for DX10 that the 
standard SVCs do not provide. Section 6 describes how to do so, and how to incorporate the new 
SVCs in the system during system generation. 

1.6 USING PRIVILEGED SVCs 

Section 7 describes certain privileged SVCs that are used almost exclusively for enhancing the 
capabilities of the operating system itself. These SVCs have a special privilege level because their 
misuse can either destroy the system by improperly and irrevocably modifying the disk, or hoard 
the system by killing other tasks. Section 7 describes these SVCs and how to use them. 

1.7 DX10 2.X COMPATIBILITY 

Section 8 describes how to transfer data files from a DX10 2.X disk to a disk from a 3.0 or later 
release of DX10. 
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2.1 INTRODUCTION 

Conventional maintenance of a system disk consists of two parts. First, you build the system disk 
by installing the software kit containing the system components. Next, you make a backup copy 
of the system disk as a security precaution. 

Section 2 begins by explaining how to build your system disk. The four procedures for Disk Build 
are as follows: 

• From the software kit shipped on disk cartridge 

• From the software kit shipped on flexible diskette 

• From the software kit shipped on tape (cartridge or reel) 

• From a DX10 system that is already running 

The first three procedures build a new DX10 operating system from the software kit shipped from 
the factory; the procedure you use depends on the shipping media. The fourth procedure is for the 
convenience of users who already have a DX10 system, but would like to make copies without hav- 
ing to build the disk again. 

The system is shipped on media compatible with your hardware; however, installation frequently 
includes transferring the data from the media on which it was shipped (for example, flexible disk- 
ette) to other media (a fixed disk). 

The section concludes by explaining procedures for customizing the initial state of your system. 
That state can be set to modify the allowed activities at any given terminal. You can modify the 
activities more at log-on time by using an M$00 command procedure. (Refer to the DX10 Oper- 
ations Guide (Volume II).) 

Once you install and back up the system, you can generate a customized operating system as 
described in Section 3. 



NOTE 

Throughout this manual, the names of keys are generic key names. 
In some cases, the names on the keycaps of the terminals match 
the generic key names, but in many cases they do not. Appendix A 
contains a table of key equivalents to identify the specific keys on 
the terminal you are using. Drawings that show the layout of the 
keyboard of each type of terminal are also included. 
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2.2 BASE SYSTEM CONFIGURATION 

The DX10 software kit ships on disk, flexible diskettes, or tape; within the constraints of your hard- 
ware, you can select the shipping medium. The installation procedure depends on your media. 
Each software kit is designed for use with a standard system configuration. 

CAUTION 

Your configuration must agree with the base system configuration 
to this extent: if you have a device in the system at a CRU or T1LINE 
address listed in the base system configuration, it must be the 
specified device type at the interrupt listed, or the system enters an 
infinite loop when it tries to process an interrupt from that device. 
Remove conflicting devices or avoid their use if a loop condition 
does not occur until you attempt to use the device. 

If you have modified your hardware configuration, return enough of 
it to the base system configuration shown in Table 3-1 or 3-2 to ful- 
fill the above rule. 



2.3 MEDIA 

Table 2-1 lists the master DX10 distribution media kits and their part numbers. Some steps in the 
installation procedure differ depending on the media type you have. Be sure to note the differ- 
ences that apply to your media type. 



Table 2-1. DX10 Distribution Media and Part Numbers 
Medium Part Number 

Disk 939151-1601 

Magnetic tape (reel or cartridge) 939151-1301, 939151-1302 

(two tapes required) 

8-inch double-sided, double-density 939151-1602 

(DSDD) flexible diskette 



2.4 COMPUTER PROGRAMMER PANEL 

Figure 2-1 shows switch and component locations on the 990 computer programmer panel 
described in the following paragraphs. Figure 2-2 shows the control/display module (CDM) for the 
990A13, which the Business System 600 and 800 use. The Business System 300 does not require a 
programmer panel. 
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Figure 2-2. Control/Display Module (CDM) 



2.5 OBJECT KITS SUPPLIED ON DISK CARTRIDGE 

Paragraph 2.5.1 presents an overview of the operation of building a system disk from a disk car- 
tridge. Detailed instructions for this operation are in paragraph 2.5.2. The system supplied by Tl 
will operate on the hardware configuration given in Table 3-1. 

2.5.1 Overview of the Disk Build Procedure 

1. Load and initialize the DX10 system that comes on the master DX10 disk cartridge. This 
procedure is the initial program load (IPL). 

2. Format and initialize a new system disk. If necessary, identify and specify known bad 
tracks on that disk to the operating system. 

3. Issue the Copy Volume (CV) command to copy the contents of the DX10 master car- 
tridge to the new system disk. 

4. Remove the master disk. 
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2.5.2 Disk Build Procedure 

To build a system disk on a base system configuration, perform the following steps: 

1. Mount the master DX10 disk cartridge in disk drive unit 1 and a blank disk cartridge in 
disk unit 0. Remove write protection from disk unit 1 and enable write protection on 
unitO. 



NOTE 

The two platters of the DS10, CD1 400/32, and CD1 400/96 disk drives 
are treated as two separate disk units. Mount the master DX10 disk 
cartridge as the removable platter. The nonremovable platter (unit 0) 
is where the new system will be built. 

2. If you are using a Business System 300, turn off power to the computer. Then, turn 
power back on and continue at step 7 of this list. 

If you are using a Business System 600 or 800, press the HALT switch and then the 
LOAD switch on the front panel and continue with step 7 of this list. 

If you are using equipment with a programmer panel (most 990 equipment), continue 
with step 3. If you are using equipment with a CDM (most 990A13-based equipment), 
press ALT LOAD and continue with step 8. 

3. Press the CLR switch and enter > 0084 on the programmer panel data switches. 

4. Press MA under ENTER and then press the CLR switch. 

5. Enter > 0400 on the programmer panel data switches and press the MDE switch. 

6. Press the LOAD switch. The computer loads and executes the disk I PL program from the 
master disk. 

7. Remove write protection from disk unit 0. 

8. Press the Attention key, release it, and hold down the Shift key while you press the 
exclamation point (!) key to activate the System Command Interpreter (SCI). (Refer to 
Appendix A for an explanation of keycap names.) When the message WARNING 
SYSTEM NOT INITIALIZED appears, return to SCI by pressing the Return key and enter 
the Initialize System (IS) command. The prompts are as follows: 

[ ] IS 

INITIALIZE DATE AND TIME 

YEAR 

MONTH 

DAY 

HOUR 

MINUTE 
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Respond to the prompts as follows: 

YEAR 

Enter a 2- or 4-dlglt integer that represents the year. For example, you can enter 
1982 or 82. 

MONTH 

Enter a 1- or 2-digit integer that represents the month. For example, you can enter 1 
or 01 to indicate January. 

DAY 

Enter a 1- or 2-dlgit integer that represents the current day. 

HOUR 

Enter a 1- or 2-digit integer that represents the current hour (according to the 24- 
hour clock). For example, 2 PM would be 14. 

MINUTE 

Enter a 1- or 2-digit integer that represents the current minute. 

9. After you initialize the system, the following message and prompts appear. Respond to 
the first two prompts by entering DUMY. Accept the default values for the next three 
prompts that appear by pressing the Return key. 



INITIALIZE SYSTEM LOG 

ATTENTION DEVICE 

LOGGING DEVICE 

SYSTEM LOG PROCESSING TASK ID 

ANALYSIS OUTPUT PRINTER 

USER LOG PROCESSOR TASK ID 



DUMY 

DUMY 

05E 

LP01 





The warmstart procedure is now complete. The system displays the following message: 
WARMSTART PROCEDURE COMPLETE: 



NOTE 

In the following step, you must enter the Initialize Disk Surface (IDS) 
command, rather than the Initialize New Volume (INV) command, if 
the diagnostic surface analysis or IDS has not previously been per- 
formed on the disk. If you specify INV when IDS is required, DX10 
will issue a message stating the need to use IDS. 
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10. Press the Return key to get to SCI command mode. Enter the INV command. The INV 
command initializes a disk — that is, deletes ail files from the file structure and builds 
the system overhead data. Initialization also allows you to assign the disk a volume 
name and an interleaving factor. For a description of the INV command, refer to the 
DX10 Operations Guide (Volume II). The following prompts appear: 

INITIALIZE NEWVOLUME 

UNIT NAME: 

VOLUME NAME: 

NUMBER OF VCATALOG ENTRIES: 

DEFAULT PHYSICAL RECORD SIZE: 

HARDWARE INTERLEAVING FACTOR: 

FORCE CLEARING OF DISK?: NO 
USED AS SYSTEM DISK?: YES 
LISTING ACCESS NAME: 
EXECUTION MODE (F,B): FOREGROUND 

Respond to the prompts as indicated: 

UNIT NAME 

The device name of the disk drive containing the target volume. Since the system 
disk did not load from the normal system disk drive (TILINE* address > F800 and 
unit select 0), the device names of the system disk drive and the drive from which 
the software kit loaded are opposite from those shown in the supported 
configuration (Table 3-1 or 3-2). In this description, DS02 references unit 0, and 
DS01 references unit 1. Enter DS02. 

VOLUME NAME 

The name of the system disk being built (for example, VOL1). The name must be 
alphanumeric — that is, from one to eight characters long, the first character of 
which must be alphabetic. 

NUMBER OF VCATALOG ENTRIES 

The number of entries in VCATALOG, the system-generated, top-level directory of 
each disk. The number of VCATALOG entries determines the amount of overhead 
available for directory and file structure. Press the Return key and DX10 will deter- 
mine the appropriate value for the disk. 

DEFAULT PHYSICAL RECORD SIZE 

The physical record size to be used for ail subsequent files created on the disk. 
Press the Return key without entering a number and DX10 will determine the appro- 
priate value. For more information on default physical record size, see Volume III. 

HARDWARE INTERLEAVING FACTOR 

The number of disk sectors occurring between consecutive accessed sections. 
This is a major factor in determining access efficiency for files on flexible diskette 
and 5.25-inch Winchester disks. Press the Return key and the system determines 
the appropriate interleaving factor for the disk type. 



* Registered trademark of Texas Instruments Incorporated. 
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FORCE CLEARING OF DISK? 

Accept the default value of NO by pressing the Return key unless the disk contains 
highly sensitive information that must be destroyed. 

USED AS SYSTEM DISK? 

Accept the default value of YES by pressing the Return key; the initialization pro- 
cess installs a bootstrap loader on the disk. 

LISTING ACCESS NAME 

Accept the default value, which is your terminal, or specify a file pathname or 
printer device name. 

EXECUTION MODE (F,B) 

The INV command procedure can execute in either foreground or background 
mode. A task executing in foreground mode executes more quickly than in back- 
ground when other activity is occurring on the system, but no other activity can 
take place at the executing terminal until the foreground task is finished. A task 
executing in background mode leaves the terminal free to execute a foreground 
task. The default value is FOREGROUND. 

BAD TRACK ACCESS NAME 

This is a hidden prompt that you can use in batch mode or in expert mode. Enter 
the pathname of the file that is to supply bad track information. The file must con- 
tain the list of bad tracks in the following format: 

HEAD, CYLINDER; 

or 
HEAD, CYLINDER; HEAD, CYLINDER; etc. 

Enter the list of known bad tracks in the requested format (for example: 2, 235; 
0, 15;). All entries, Including the last, must end with a semicolon. All numbers 
entered are assumed to be decimal. Note that unlike the IDS command, for which 
you can enter ME in response to this prompt, you can only supply the list of bad 
tracks in a file for the INV command. 

Specifying the list of bad tracks for a DS25 requires special consideration. The bad 
tracks labeled on the side of the disk pack are labeled as if the pack were formatted 
as a DS50. For a DS25, however, the system uses half of the cylinders that it uses 
for a DS50. Therefore, for a DS25, ignore all bad tracks listed for odd numbered cyl- 
inders. For each bad track on the disk label with an even numbered cylinder, divide 
the cylinder number (not the head number) by two, and enter the result for the 
cylinder number of the bad track. 

When you enter the last prompt response, the INV command begins to format the 
disk. This procedure may access every track on the disk depending on the options 
and the condition of the disk. A typical moving-head disk (DS10 for example) 
requires two minutes to complete the format function. The actual time varies with 
disk speed, access time, and capacity. 
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1 1 . Enter the CV command to copy the master disk to the blank disk. For more information 
about the CV command, refer to the DX10 Operations Guide (Volume II). The prompts are 
as follows: 

COPY VOLUME 

SOURCE DISK UNIT: 

SOURCE VOLUME NAME: 

DESTINATION DISK UNIT: 

DESTINATION VOLUME NAME: 

LISTING DEVICE: 

VERIFY?: YES 
CONVERT SEQUENTIAL FILES?: NO 
CONVERT REL-REC FILES?: NO 
MORE COPIES?: NO 

SOURCE DISK UNIT 

The name of the source disk unit in the form DSxx, where xx is a disk unit number 
from 01 to 99. Enter DS01. 

SOURCE VOLUME NAME 

The volume name of the disk to be copied. Enter REL36. 

DESTINATION DISK UNIT 

The name of the destination disk unit in the form DSxx, where xx is a disk unit 
number from 01 to 99. Enter DS02. 

DESTINATION VOLUME NAME 

The volume name of the disk to which CV copies the disk identified by the source 
volume name. Enter the name that you entered in response to the VOLUME NAME 
prompt in the INV command. 

LISTING DEVICE 

Enter the device name of the terminal (STxx) that is to be the listing device. If a 
listing is not required, enter DUMY. 

VERIFY? 

Although it is not recommended, a copy can be performed without verification if 
you enter NO in response to this prompt. The initial value is YES. 

CONVERT SEQUENTIAL FILES? 

If the two disks Involved in the copy process do not have the same default physical 
record lengths, physical record length conversion allows more efficient use of the 
destination disk. You can request physical record length conversion for sequential 
files by responding YES. The initial value is NO. 
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CONVERT REL-REC FILES? 

If the two disks involved in the copy process do not have the same default physical 
record lengths, physical record length conversion allows more efficient use of the 
destination disk. Also, if the two disks have the same sector sizes, responding YES 
to this prompt allows CV to perform full compression on unbounded program files. 
You can request physical record length conversion for relative record files by 
responding YES. The initial value is NO. 

MORE COPIES? 

Enter YES if you wish to make a series of copies. Your terminal then displays the 
full set of prompts for the next copy to be made. You can make as many as nine 
copies in a single execution of CV. The initial value is NO. 

The new DX10 system disk has been built. You can now load the system from the new disk. If the 
standard ROM bootstrap loader is available, loading involves no more than pressing the HALT 
switch and then the LOAD switch on the front panel or, for a Business System 300, turning the 
power off and on one time. However, before loading the new system and beginning operations (or 
beginning to generate a custom system), make sure to copy your operating system and store the 
copy in a safe place. That way, if anything happens to your system disk, you do not have to build 
another. Refer to Volume II for information on backing up your system disk. 

2.6 OBJECT KITS SUPPLIED ON MULTIPLE FLEXIBLE DISKETTE MEDIA 

This procedure explains how to use the Disk Build utility to transfer an object kit (typically, operat- 
ing system software) from a backup copy on several flexible diskettes to a single fixed disk (the 
target disk). The Disk Build utility is designed for systems based on a WD500 disk drive. The 
WD500 has a single flexible diskette drive which cannot contain all of the DX10 software at one 
time and a disk drive whose disk cannot be removed. Therefore, the operating system must reside 
on the fixed disk, but must be copied to the fixed disk from a series of removable diskettes. 

Disk Build can be used with any system that has both a flexible diskette drive and a rigid disk 
drive. This procedure assumes that the system includes a WD500 in the standard configuration 
(see Table 3-1). You may need to change your system to match the configuration in Table 3-1. You 
must also have a set of special flexible diskettes consisting of an initial build diskette (which con- 
tains the Disk Build utility) and three or more backup diskettes (which contain the new operating 
system and system files). 

You use Disk Build for any of the following: 

• Building the initial system 

• Rebuilding a destroyed system 

• Replacing an operating system with a new one 
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NOTE 

Rebuilding a destroyed system (including your application files and 
programs) with the Disk Build utility requires that you have pre- 
viously backed up your operating system software on flexible disk- 
ettes using the Backup Directory (BD) or Backup Directory to Device 
(BDD) command. If you want to accept the default values during 
Disk Build, you must name the backup file "DX.SYSTEM" when you 
issue the BD command. 

2.6.1 Disk Build Procedure with a WD500 in Standard Configuration 

The following procedure initiates and executes Disk Build. To terminate Disk Build prematurely, 
enter a dollar sign ($) whenever a prompt offers an opportunity to respond. To begin the procedure, 
first mount the build diskette into the flexible diskette drive; do not write protect the diskette. 
Ensure that the Winchester disk(s) is in a ready state and write protected. To load the Disk Build 
utility from the diskette to system memory, perform an IPL from the flexible diskette, as follows: 

1 . If you are using a Business System 300, turn off power to the computer. Then turn power 
on again and continue with step 7 of this list. 

If you are using a Business System 600 or 800, press the HALT switch and then the 
ALTERNATE LOAD switch on the front panel. Then continue with step 7 of this list. 

If you are using equipment with a programmer panel (most 990 equipment), continue 
with step 2. 

2. Press CLR and enter > 0084 on the programmer panel data switches. 

3. Press ENTER MA on the programmer panel. 

4. Press MDD and enter > 0200 on the programmer panel data switches. 

5. Press MDE on the programmer panel. 

6. Press LOAD. The loader code begins loading the Disk Build software. 

7. Remove write protection from the Winchester disk. 

After the system loads the Disk Build software, it immediately begins executing and displays the 
following message on one or more terminals: 

***DISK BUILD UTILITY*** 

DO YOU WANT TO CHANGE ANY DEFAULT VALUES? (Y/N): 

The appropriate response to this question is N except in three cases: 

• When the target disk is not located at the TILINE address default value, > F800, unit 
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• When you wish to set special values for the following system disk parameters: volume 
name, physical record size, number of VCATALOG (the volume directory) entries, or 
hardware interleaving factor 

• When you wish to specify a source file other than the default file (DX.SYSTEM) on the 
backup disks 

In any of these three cases, enter a Y in response to the message and refer to the paragraph 2.6.2 
for further explanation. 

Whether you enter Y or N, only the terminal you are using remains active. All other terminal 
screens that displayed the introductory message become clear. A digital clock display appears in 
the bottom right corner of your screen and monitors the execution time of the Disk Build utility. 

Disk Build now inspects the target disk and evaluates its condition. Depending on the condition of 
the disk, one of the following messages appears: 

DISK REQUIRES SURFACE ANALYSIS 

or 
DISK REQUIRES INITIALIZATION 

or 

VOLUME NAME: xxxxxxxx 
THE SPECIFIED DISK COULD CONTAIN SOME 
INFORMATION ABOUT YOUR BUSINESS. 
IF N IS ENTERED, THE DISK WILL BE 
ERASED. IF Y IS ENTERED, ONLY SYSTEM 
INFORMATION WILL BE ERASED. IFTHERE IS 
INFORMATION THAT MUST BE SAVED, ENTER 
Y. IF THE INFORMATION CAN BE 
REPLACED, ENTER N. 

SHOULD THE USER INFORMATION ON THE SYSTEM 
DISK BE SAVED?(Y/N) 

The message DISK REQUIRES SURFACE ANALYSIS appears if Disk Build does not find a bad 
track map on the target disk. As Disk Build begins the work of analyzing and formatting the disk, 
the following message appears: 

BEGIN STEP 1. 

Disk Build automatically issues an IDS command, which analyzes the target disk surface for phys- 
ical flaws and lists the location of any flaw on a bad track map. As Disk Build performs the IDS 
command, a graph is displayed to show the percentage of surface analysis completed. When IDS 
completes, a list of bad tracks is displayed. Then, Disk Build performs an INV command, which 
creates a volume directory, assigns a volume name, ano! installs the volume on the target disk. In 
this case, Disk Build uses default values for the INV parameters. 
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The message DISK REQUIRES INITIALIZATION appears on the screen if Disk Build determines 
that an IDS has been performed on the target disk but that VCATALOG does not exist. The follow- 
ing message appears: 

BEGIN STEP 1. 

Disk Build automatically issues an INV command on the target disk using default values. 

The third message appears on the screen if Disk Build finds VCATALOG on the target disk. This 
message means that software or data might already exist on the target disk. If you have previously 
created directories or installed programs, you may wish to preserve them. If so, enter Y. Disk Build 
then issues the Install Volume (IV) command. If you do not wish to save the previously existing 
software, enter N. Disk Build will then issue an INV command. 

Under any circumstances Disk Build deletes the following system files: 

.S$PROGA 

.S$IMAGES 

.S$LOADER 

.S$TCALIB 

.S$OVLYA 

.S$SDS$ 

Any data in these files is destroyed. 

If Disk Build issues an IDS command, a graph is displayed to show the percentage of surface anal- 
ysis completed. When IDS completes, a list of bad tracks is displayed. 

Once the new volume is installed, Disk Build copies the remainder of the Disk Build operating sys- 
tem software from the build diskette to the target disk using the CD command. During this pro- 
cess, the following message appears on the terminal: 

BEGIN STEP 2. 

During the CD process, Disk Build creates a listing file called .B$LISTCD on the target disk. At this 
time, the system files are recreated. The following message appears on the terminal: 

REMOVE INITIAL BUILD MEDIA. 
THEN TYPE Y TO CONTINUE: 

Remove the build diskette from the diskette drive. 
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When you type Y, Disk Build automatically loads the system from the newly created files on the 
target disk. The following message appears on the screen: 

SYSTEM LOAD INITIATED — WAIT ONE MINUTE. 
IF NO MESSAGES APPEAR, START OVER AT STEP 1 . 

• If no messages appear on the screen after one minute, the load process was not suc- 
cessful. The data lights on the front panel should display a crash code. For an explana- 
tion of crash codes, refer to DX10 Error Reporting and Recovery Manual (Volume VI). 
After correcting the cause of the crash, repeat this procedure from the IPL. 

• If the load is successful, the following message appears on the terminal: 

MOUNT BACKUP DATA VOLUME 1. 
THEN TYPE Y TO CONTINUE: 

Insert the first backup diskette, labeled Backup Disk Volume 1. 

When the diskette is ready, enter Y. A response other than Y (or $, which aborts Disk Build) causes 
the message MOUNT BACKUP DATA VOLUME 1 to reappear. 

Disk Build issues a Restore Directory (RD) command to copy the first part of the operating system 
software from the source diskette to the target disk. The following message appears on the 
screen: 

BEGIN STEP 3. 

During this step, Disk Build deletes any files that could cause a conflict with the new system. 
Specifically, Disk Build deletes .SSPROGA, .S$SDS$, and .S$IMAGES. Disk Build issues a Modify 
File Protection (MFP) command to allow replacement of .S$LOADER, .S$TCALIB, and .S$OVLYA. 

Disk Build requests additional volumes as needed; the following message appears on the screen: 

MOUNT VOLUME < x> ; TYPE $ TO QUIT; Y TO CONTINUE: 

In this message, < x> is the number of the next volume to install. 

Remove the current diskette and mount volume < x> as requested. 

When Disk Build has copied the entire DX10 operating system to the target disk, the following 
message appears on the screen: 

BUILD PROCESS COMPLETED. 
REMOVE BACKUP MEDIA. 
THEN TYPE Y TO CONTINUE: 

Remove the diskette. When you type Y, the following message appears on the screen: 

SYSTEM LOAD INITIATED — WAIT 1 MINUTE. 
THEN LOG ON. 
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After four seconds, the system initiates an IPL and the screen becomes blank. When the IPL fin- 
ishes, the DX10 operating system is loaded, and your computer is functional. To access SCI, press 
the Attention key, release it, and hold down the Shift key while you press the exclamation point (!) 
key. (Refer to Appendix A for an explanation of keycap names.) The following message appears on 
the bottom line of the screen: 

WARNING! SYSTEM IS NOT INITIALIZED: 

If this warning message does not appear, observe the data lights on the front panel for a crash 
code. 

At this point you have installed the DX10 operating system. It is necessary to issue an IS com- 
mand to the system. The prompts are as follows: 

[ ]IS 

INITIALIZE DATE AND TIME 

YEAR 

MONTH 

DAY 

HOUR 

MINUTE 

Respond to the prompts as follows: 

YEAR 

Enter a 2- or 4-dlgit integer that represents the year. For example, you can enter 1982 or 
82. 

MONTH 

Enter a 1- or 2-digit integer that represents the month. For example, you can enter 1 or 01 
to indicate January. 

DAY 

Enter a 1- or 2-digit integer that represents the current day. 

HOUR 

Enter a 1- or 2-digit integer that represents the current hour (according to the 24-hour 
clock). For example, 2 PM would be 14. 

MINUTE 

Enter a 1- or 2-digit integer that represents the current minute. 
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After you initialize the system, the following message and prompts appear. You should initialize 
the system log so that it only uses files for log messages. The following example demonstrates 
this: 



INITIALIZE SYSTEM LOG 

ATTENTION DEVICE 

LOGGING DEVICE 

SYSTEM LOG PROCESSING TASK ID 

ANALYSIS OUTPUT PRINTER 

USER LOG PROCESSOR ID 



DUMY 

DUMY 

05E 

LP01 





The warmstart procedure is complete. The system briefly displays the following message: 

WARMSTART PROCEDURE COMPLETE: 
When initialization is complete, you can customize your system, if necessary (see Section 3). 

NOTE 

The following file names are reserved pathnames. Do not use these 
pathnames for your own files because the Disk Build deletes them: 

.B$PROGA 

.B$LOADER 

.B$PASS 

.B$CONTRL 

.B$LISTRD 

.BSLISTCD 

.BSOVLYA 

2.6.2 Variations to Disk Build Procedure when Changing Default Values 

When the Disk Build utility begins execution, the message DO YOU WANT TO CHANGE DEFAULT 
VALUES? (Y/N) appears on the terminal screen. Enter Y in any of the following cases: 

• The system disk (target disk) is not located at TILINE address > F800, unit 0. 

• You wish to change one or more volume characteristics. 

• You wish to specify your own backup file (other than the default backup file, 
DX.SYSTEM). If your response is N, this paragraph does not apply to your Disk Build 
procedure. 
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During the execution of Disk Build, you have three opportunities to change default values: 

• When Disk Build is being loaded, you can specify the location of the system (target) 
disk. 

• Before Disk Build copies itself from the initial build diskette to the target disk, you can 
change the default volume characteristics of the target disk. 

• Before Disk Build restores the first backup diskette to the target disk, you can name 
your backup file. 

2.6.2.1 Specifying the Target Disk. Immediately after you respond Y to the previously displayed 
question, DO YOU WANT TO CHANGE DEFAULT VALUES?, a message appears on the screen. 
The content of this message varies with each system, depending on what drives are configured 
and online with the particular system. The following message is a typical example: 

SYSTEM WILL BE BUILT ON ONE OF THE FOLLOWING DISKS: 

ID ADDRESS UNIT INTERRUPT TYPE 

1 F800 01 13 WD500 — 5M 

2 F800 00 13 WD500 — 5M 

3 F820 00 9 FD1000 — 1M 
INPUT ID NUMBER OF DESIRED DISK UNIT: 

The table of disk drives listed in the message represents all of the disks that are online in the 
computer system. Choose the disk you want to be the system disk (target disk) for your computer, 
and enter the corresponding ID number from the left-hand column of the table. 

2.6.2.2 Changing Volume Characteristics of the Target Disk. Next, Disk Build inspects the tar- 
get disk and evaluates its condition. Depending on the condition of the disk, one of the following 
messages appears: 

DISK REQUIRES SURFACE ANALYSIS 

or 
DISK REQUIRES INITIALIZATION 

or 

VOLUME NAME: xxxxxxxx 
THE SPECIFIED DISK COULD CONTAIN SOME 
INFORMATION ABOUT YOUR BUSINESS. 
IF N IS ENTERED, THE DISK WILL BE 
ERASED. IF Y IS ENTERED, ONLY SYSTEM 
INFORMATION WILL BE ERASED. IF THERE IS 
INFORMATION THAT MUST BE SAVED, ENTER 
Y. IF THE INFORMATION CAN BE 
REPLACED, ENTER N. 

SHOULD THE USER INFORMATION ON THE SYSTEM 
DISK BE SAVED?(Y/N) 
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The prompts that follow the first two messages (DISK REQUIRES SURFACE ANALYSIS and DISK 
REQUIRES INITIALIZATION) allow you to change default values. The other message is the same 
as if you were accepting defaults; treat it as described previously. 

If the message DISK REQUIRES SURFACE ANALYSIS appears, Disk Build has determined that it 
must issue an IDS and an INV command on the target disk. The following prompts appear: 



VOLUME NAME 

NUMBER OF VCATALOG ENTRIES 

PHYSICAL RECORD SIZE 

HARDWARE INTERLEAVING FACTOR 



(SYSTEM) 

(XXX) 



You can change these four target disk parameters that are set during the INV command. 

VOLUME NAME 

If the default volume name SYSTEM is acceptable, press the Return key on your ter- 
minal. If you want to designate another name, enter that name at this time. The volume 
name can be up to eight characters long. 

PHYSICAL RECORD SIZE 

The default value of the physical record size depends on the model of the target disk. To 
designate a particular physical record size, enter that value in decimal notation. Refer to 
Volume III for more information on default physical record size. 

NUMBER OF VCATALOG ENTRIES 

To designate your own value for this prompt, enter that value now. Although no default 
value appears for this prompt, Disk Build supplies a default value if you press the Return 
key without entering a value. The default value varies depending on the model of the 
target disk. 

HARDWARE INTERLEAVING FACTOR 

To designate your own value for this prompt, enter that value now. Although no initial 
value appears, Disk Build supplies a default value if you press the Return key without 
entering a value. 

After you answer this set of prompts, the following prompt appears: 

RESTORE BAD TRACK LIST? _ 

If you want to restore the bad track list if available, answer Y. If you answer N or receive an error 
after answering Y, Disk Build performs the IDS command. 

When you answer Y, the following prompts appear: 

ENTER BAD TRACKS IN THE FORMAT: 

HEAD, CYLINDER; 

OR 
HEAD, CYLINDER; HEAD, CYLINDER; ETC. 

TO END LIST, ENTER AN EMPTY LINE 
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Enter the list of known bad tracks in the requested format using decimal numbers for the values 
(for example, 2, 235; 0, 15;). All entries, including the last, must end with a semicolon. Improper 
positioning or absence of the punctuation marks causes an error to be returned. 

When you use the INV command for a DS25 disk, divide cylinder addresses in half before entering 
them in response to the BAD TRACK FORMAT message. Because the DS25 uses every other cylin- 
der on the disk pack, all tracks with odd cylinder addresses are ignored. You must enter the 
addresses (divided by two) of even number tracks only. For example, to enter HEAD number 4, 
CYLINDER number 422, you would respond to the BAD TRACK FORMAT message as follows: 

HEAD 4 CYLINDER 211 

If the message DISK REQUIRES INITIALIZATION appears, Disk Build has determined that the tar- 
get disk has been analyzed but not initialized. A series of prompts follow. These prompts also 
appear if you answer N to the question SHOULD THE USER INFORMATION ON THE SYSTEM 
DISK BE SAVED?(Y/N) in the third message and you previously answered Y to change the default 
values. The first prompt is as follows: 

PERFORM INV? 

If you want to reformat the disk, answer Y. (This is the equivalent of issuing the INV command with 
the forced clearing of disk specified.) Otherwise, answer N. 

If you answer Y, the following prompt appears: 

PERFORM IDS? 

If you want to perform surface analysis of the disk regardless if it has been done before, answer Y. 
Otherwise, answer N. 



The following prompts appear next: 

VOLUME NAME 

NUMBER OF VCATALOG ENTRIES 

PHYSICAL RECORD SIZE 

HARDWARE INTERLEAVING FACTOR 



(SYSTEM) 
(xxx) 



You can change these four target disk parameters that are set during the INV command. These 
prompts and the following prompt are discussed in the preceding explanation for the DISK 
REQUIRES SURFACE ANALYSIS message. 

RESTORE BAD TRACK LIST? _ 

At this point, Disk Build continues to run in the same way as if you had chosen to accept default 
values. Disk Build performs either an IDS or an INV command (step 1) or an IV command. Then, 
Disk Build copies the first diskette to the target disk (step 2) and performs an I PL. If the I PL is suc- 
cessful, a message appears instructing you to replace the initial build diskette with the first 
backup diskette and enter a Y to initiate an RD command. 
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2.6.2.3 Specifying the Backup File. When Disk Build restores the directory from the backup 
diskette to the target disk, the default pathname of the target directory is DX.SYSTEM. If you have 
chosen to change default values, the following message appears on the screen: 

ENTER THE PATHNAME OF SEQUENTIAL BACKUP FILE: DX.SYSTEM 

Enter the pathname of the backup file for the RD command. 

This concludes the differences between the default-accepting mode and the default-changing 
mode. Disk Build will display messages requesting the backup disks. Disk Build continues from 
this point as described in the standard DSKBLD procedure described in paragraph 2.6.1. 

2.6.3 Variations to Disk Build Procedure for FD1000 

You should configure your equipment so it conforms to the DS04 device as given in Table 3-1. If 
you are using equipment with a programmer panel (most 990 equipment), enter > 0082 on the data 
switches in step 2 instead of > 0084. In step 4, enter > F810 on the data switches instead of > 0200. 
Then continue with step 6. If you are using equipment with a CDM (most 990A13-based equip- 
ment), press ALT LOAD in step 2. 

2.7 OBJECT KITS SUPPLIED ON TAPE MEDIA 

The following procedure describes how to generate a DX10 operating system on a disk cartridge 
from the two tape reels or cartridges that make up the tape medium software kit. The procedure 
assumes the use of the standard ROM loader, a base system configuration (see Table 3-1 or 3-2 in 
Section 3), and either a 91 1 VDT, a 940 EVT, or a Business System VDT. 

CAUTION 

The program for building the disk from tape assumes that the 
devices listed in Table 2-2 are assigned the corresponding 
interrupt. Otherwise, the system goes into an infinite loop when it 
tries to process an interrupt from that device. 
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Table 2-2. Minimum Configuration for TAPBLD 



Device 


Address 


Interrupt 


Baud Rate 


Disk 

Magnetic tape 
911 VDT 


TILINE>F800 
TILINE>F880 
CRU>0100 


13 (unit 0) 
9 (unit 0) 
10 




Business 
System terminal 

or 
931 VDT 
(channel 0)* 


CRU>1700 
TILINE>F980 


8 
or 

11 


9600 
9600 



Note: 

* You can configure a Business System terminal or a 931 VDT at either CRU address > 1700, inter- 
rupt 8, or TILINE address > F980, interrupt 11. The terminal should use 9600 baud. 



To begin the Disk Build from magnetic tape, perform the following steps: 

1. Mount the software kit magnetic tape labeled BUILD TAPE (TI part number 939151-1301) 
on tape unit with write protection enabled and make tape unit ready for operation. 

2. Place a disk cartridge on the system disk drive (first controller) unit 0, and make disk 
unit ready for operation with the write protection enabled. 

3. If you are using a Business System 300, turn off power to the computer. Then, turn 
power back on and continue after step 9 of this list. 

If you are using a Business System 600 or 800, press the HALT switch and then the 
ALTERNATE LOAD switch on the front panel. Then continue after step 9 of this list. 

If you are using equipment with a programmer panel (most 990 equipment), continue 
with step 4. If you are using equipment with a CDM (most 990A13-based equipment), 
press the HALT switch and then the ALT LOAD switch, and continue after step 9 of this |~ 
list. 

4. Press the CLR switch, and enter > 0082 in the programmer panel data switches. 

5. Press the ENTER MA switch on the programmer panel. 

6. Press the CLR switch, and enter > F880 in the programmer panel data switches. 

7. Press the MDE and MAI switches on the programmer panel (in succession). 

8. Press the CLR switch, and enter > 8000 in the programmer panel data switches. 

9. Press the MDE switch and then the LOAD switch on the front panel. 
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The tape unit then reads the TAPBLD program from the tape to memory. This program contains 
several steps performed automatically. Appropriate messages appear on the screen as each step 
executes. Once the program is loaded and begins execution, the following message is displayed 
on one or more of the terminals: 

***DISK BUILD UTILITY*** 

DO YOU WANT TO CHANGE ANY DEFAULT VALUES? (Y/N): 

At this point, remove write protection from the disk unit. 

The appropriate response to this question is N except when you wish to set special values for the 
following system disk parameters: volume name, physical record size, number of VCATALOG (the 
volume directory) entries, or hardware interleaving factor. 

If you want to set special values for these items, enter a Y in response to the message and refer to 
paragraph 2.7.1 for further explanation. 

Whether you enter Y or N, only the terminal you are using remains active. All other terminal 
screens that displayed the introductory message become clear. A digital clock display appears in 
the bottom right corner of your screen and monitors the execution time of the Tape Build utility. 

Tape Build now inspects the target disk and evaluates its condition. A running account of the data 
tracks as they are accessed appears in the top righthand corner of the screen. Depending on the 
condition of the disk, one of the following messages appears: 

DISK REQUIRES SURFACE ANALYSIS 

or 

DISK REQUIRES INITIALIZATION 

The message DISK REQUIRES SURFACE ANALYSIS appears if Tape Build does not find a bad 
track map on the target disk. As Tape Build begins the work of analyzing and formatting the disk, 
the following message appears: 

BEGIN STEP 1. 

Tape Build automatically issues an IDS command, which analyzes the target disk surface for 
physical flaws and lists the location of any flaw on a bad track map. As Tape Build performs the 
IDS command, a graph is displayed to show the percentage of surface analysis completed. When 
IDS completes, a list of bad tracks is displayed. Then, Tape Build performs an INV command, 
which creates a volume directory, assigns a volume name, and installs the volume on the target 
disk. In this case, Tape Build uses default values for the INV parameters. 

The message DISK REQUIRES INITIALIZATION appears on the screen if Tape Build determines 
that an IDS has been performed on the target disk but that VCATALOG does not exist. The follow- 
ing message appears: 

BEGIN STEP 1. 

Tape Build automatically issues an INV command on the target disk using default values. 
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Once the new volume is logically installed, Tape Build copies the remainder of the Tape Build 
operating system software from the tape to the target disk. During this process, the following 
message appears on the terminal: 

BEGIN STEP 2. 

At this time, the system files are recreated. As directories and files are created, their names 
appear on the screen, as follows: 

**VCATALOG** 

**S$DIAG** 

**S$ROLLA** 

**B$LOADER** 

**B$PROC** 

**B$OVLYA** 

**S$IMAGES** 

**B$PROGA** 

**B$PASS** 

S$DIAG is not created on an FD1000 floppy disk. 

Tape Build automatically loads the system from the newly created files on the target disk. The fol- 
lowing message appears on the terminal: 

REMOVE INITIAL BUILD MEDIA. 
TYPE Y TO CONTINUE: 

Unload and remove the tape. When you type Y, the following message appears on the terminal: 

SYSTEM LOAD INITIATED — WAIT ONE MINUTE 
IF NO MESSAGES APPEAR, START OVER AT STEP 1 

If no further messages appear on the screen after one minute, the load process was not success- 
ful. The data lights on the computer chassis should display a crash code. For an explanation of 
crash codes, refer to Volume VI. After correcting the cause of the crash, repeat this procedure 
from step 1 in the preceding list. 

If the load is successful, the following message appears on the terminal: 

MOUNT BACKUP DATA VOLUME 1 
THEN TYPE Y TO CONTINUE 

Insert the backup tape, labeled Backup Tape Volume 1. 

When the tape is ready, enter Y. A response other than Y (or $, which aborts Tape Build) causes the 
message MOUNT BACKUP DATA VOLUME I to reappear. 

Tape Build issues an RD command to copy the first part of the operating system software from the 
source tape to the target disk. The following message appears on the screen: 

BEGIN STEP 3. 
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During this step, Tape Build deletes any files that could cause a conflict with the new system. 
Specifically, Tape Build deletes .S$PROGA, .S$SDS$, and .S$IMAGES. Tape Build issues an MFP 
command to allow replacement of .S$LOADER, .S$TCALIB, and .S$OVLYA. 

Tape Build requests additional volumes as needed; the following message appears on the screen: 

MOUNT VOLUME < x> ; TYPE $ TO QUIT; Y TO CONTINUE: 

In this message, x is the number of the next volume to install. 

When Tape Build has copied the entire DX10 operating system to the target disk, the following 
message appears on the screen: 

BUILD PROCESS COMPLETED. 
REMOVE BACKUP MEDIA. 
THEN TYPE Y TO CONTINUE: 

Unload and remove the tape. When you type Y, the following message appears on the screen: 

SYSTEM LOAD INITIATED — WAIT 1 MINUTE. 
THEN LOG ON. 

After four seconds, the system executes an I PL and the screen becomes blank. When the I PL is 
complete, the screen remains blank. The DX10 operating system is now loaded, and your com- 
puter is functional. To access SCI, press the Attention key, release it, and hold down the Shift key 
while you press the exclamation point (!) key. (Refer to Appendix A for an explanation of keycap 
names.) The following message appears on the bottom line of the screen: 

WARNING! SYSTEM IS NOT INITIALIZED: 

If this warning message does not appear, observe the data lights on the front panel for a crash 
code and refer to Volume VI. 

Otherwise, issue an IS command to the system. The prompts are as follows: 

MIS 

INITIALIZE DATE AND TIME 

YEAR: 

MONTH: 

DAY: 

HOUR: 

MINUTE: 

Respond to the prompts as follows: 

YEAR 

Enter a 2- or 4-digit integer that represents the year. For example, you can enter 1982 
or 82. 
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MONTH A _. 

Enter a 1- or 2-digit integer that represents the month. For example, you can enter 1 or 01 

to indicate January. 

DAY 

Enter a 1- or 2-digit integer that represents the current day. 

HOUR 

Enter a 1- or 2-digit integer that represents the current hour (according to the 24-hour 

clock). For example, 2 PM would be 14. 

MINUTE 

Enter a 1- or 2-digit integer that represents the current minute. 

After you initialize the system, the following message and prompts appear. Respond to the first 
two prompts by entering the device name ME, as follows: 

INITIALIZE SYSTEM LOG 

ATTENTION DEVICE: ME 
LOGGING DEVICE: ME 

Accept the initial values for the next three prompts that appear by pressing the Return key. 

SYSTEM LOG PROCESSING TASK ID: 05E 
ANALYSIS OUTPUT PRINTER: LP01 
USER LOG PROCESSOR TASK ID: 

The warmstart procedure is complete. The system displays the following message: 

LOG STARTED 

WARMSTART PROCEDURE COMPLETE: 
When initialization is complete, you can customize your system, if necessary (see Section 3). 
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NOTE 

The following file names are reserved pathnames. Do not use these 
pathnames for your own files because the Tape Build deletes them: 



.B$PROGA 

.B$LOADER 

.B$PASS 

.B$CONTRL 

.B$LISTRD 

.BSOVLYA 

.B$LISTCD 



2.7.1 Variations to Tape Build Procedure when Changing Default Values 

When the Tape Build utility begins execution, the message DO YOU WANT TO CHANGE DEFAULT 
VALUES? (Y/N) appears on the terminal screen. Enter Y if you want to change one or more volume 
characteristics. If your response is N, this paragraph does not apply to your Tape Build procedure. 

After you respond Y to the question, a message appears on the screen. The content of this mes- 
sage varies with each system, depending on which drives are configured with the system. The fol- 
lowing message is a typical example: 



SYSTEM WILL BE BUILT ON ONE OF THE FOLLOWING DISKS: 



ID 
1 
2 
3 

4 



ADDRESS 

F800 

F800 

F800 

F800 



UNIT 
01 
02 
03 
04 



INPUT ID NUMBER OF DESIRED DISK UNIT: 



INTERRUPT 
13 
13 
13 
13 



TYPE 
WD800 — 43MB 
WD500A — 20MB 
WD500A — 20MB 
UNKNOWN DISK 



The table of disk drives listed in the message represents disks that may be specified to build the 
initial system. Choose the disk that is online to your system, and enter the corresponding ID 
number from the left-hand column of the table. 

Before Tape Build copies itself from the initial build tape to the target disk, you can change the 
default volume characteristics of the system disk. Tape Build inspects the target disk and evalu- 
ates its condition. Depending on the condition of the disk, one of the following messages 
appears: 
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DISK REQUIRES SURFACE ANALYSIS 

or 

DISK REQUIRES INITIALIZATION 

The prompts following the two messages, DISK REQUIRES SURFACE ANALYSIS and DISK 
REQUIRES INITIALIZATION, allow you to change default values. 

If the message DISK REQUIRES SURFACE ANALYSIS appears, Tape Build has determined that it 
must issue an IDS and INV command on the target disk. The following prompts appear: 

VOLUME NAME: (SYSTEM) 
NUMBER OF VCATALOG ENTRIES: 
DEFAULT PHYSICAL RECORD SIZE: (xxx) 
INTERLEAVING FACTOR: 
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You can change these four target disk parameters that are set during the INV command. 

VOLUME NAME 

If the default volume name SYSTEM is acceptable, press the Return key on your ter- 
minal. If you want to designate another name, enter that name at this time. The volume 
name can be up to eight characters long. Note that you cannot backspace the cursor 
while responding to this prompt. Be sure to enter the VOLUME NAME correctly the first 
time. 

DEFAULT PHYSICAL RECORD SIZE 

The default value of the physical record size depends on the model of the target disk. To 
designate a particular physical record size, enter that value in decimal notation. Refer to 
Volume III for more information on default physical record size. 

NUMBER OF VCATALOG ENTRIES 

To designate your own value for this prompt, enter that value now. Although no default 
value appears for this prompt, Tape Build supplies a default value if you press the 
Return key without entering a value. The default value varies depending on the model of 
the system disk. 

INTERLEAVING FACTOR 

To designate your own value for this prompt, enter that value now. Although no initial 
value appears, Tape Build supplies a default value if you press the Return key without 
entering a value. 

After you answer this set of prompts, the following prompt appears: 

RESTORE BAD TRACK LIST? _ 

If you want to restore the bad track list if available, answer Y. If you answer N or receive an error 
after answering Y, Disk Build performs the IDS command. 

When you answer Y, the following prompts appear: 

ENTER HEAD AND CYLINDER ADDRESS OF KNOWN BAD TRACKS. 

ENTER THE ADDRESSES ONE PER LINE. 

END THE LIST BY ENTERING RETURN ONLY FOR THE NEXT HEAD. 

HEAD# 

Enter the addresses of any known bad tracks on this volume. Enter the decimal number for the 
head on the line prompting HEAD #. Then press the Return key. Do not use any special characters 
such as commas or semicolons. Tape Build then issues the prompt CYLINDER #. Enter the deci- 
mal value of the cylinder number immediately after this prompt. Then press the Return key. Do not 
use any special characters such as commas or semicolons. Tape Build then prompts you for the 
next head and cylinder number in the same manner. When the list of head and cylinder pairs is 
complete, press only the Return key in response to the HEAD # prompt to terminate your input. 

When you use the INV command for a DS25 disk, divide cylinder addresses in half before entering 
them in response to the CYLINDER # prompt. Because the DS25 uses every other cylinder on the 
disk pack, all tracks with odd cylinder addresses are ignored. You must only enter the addresses 
(cylinder divided by two) of tracks with even cylinder numbers. 
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2.8 DUPLICATION OF A BUILT SYSTEM 

You can create a copy of a system disk capable of performing an I PL with one of several methods. 
If your system has more than one disk drive, you can produce a copy directly by using the Copy 
Volume (CV) command. If the disks are the same type, you can use the CVD or DCOPY command. 
If you have only one disk and it is removable, and you have a magnetic tape, you can use DCOPY. 
If your only disks are not removable, the best way is to use the procedures in paragraph 2.10 to 
create a backup that can be used with Disk Build; then use BDD to back up your data files. 

You can create a system disk by using the following steps 1 through 5. This method is useful if 
your output disk is too small to use CV, or if you wish to produce a system disk that has fewer 
functions than a complete DX10 system. If you are trying to produce a smaller version of a DX10 
system, you can delete tasks from S$IMAGES and S$PROGA, and you can delete command proce- 
dures from S$PROC. Volume II contains information in the SCI command index table on what 
parts of S$PROGA are used to service the command procedures. Make a copy of the program 
files; delete the desired tasks, procedures, and overlays from the copy; and copy twice with CD to 
compress the program files. 

The system files necessary to have an operational DX10 system are S$PROC, S$OVLYA, 
S$LOADER, S$PROGA, and S$IMAGES. You need to have the procedures necessary for system 
initialization and application execution in S$PROC. 

1 . Place a new disk volume in a secondary disk unit. 

2. Initialize the volume using the INV command. Answer YES to the USED AS SYSTEM 
DISK prompt to install the bootstrap loader on the disk. 

3. Issue the CD command to copy the desired files to the new disk. (These files are the sys- 
tem files mentioned previously and whatever other files and directories are necessary 
for the system's intended use.) If you use the RPRL option, be sure to recopy 
.S$SYSGEN.GENDAT without RPRL. Use the Verify Copy (VC) command to verify the 
copy. Accept the default value to include the system files. 

4. Enter the CSF command to create the .S$PRINT, .S$ROLLA, and .S$CRASH system 
files. 

5. Use the MVI command to specify to the system loader the names of the primary system 
image, the program file, the overlay file, and the loader file. 

Refer to Volume II for detailed descriptions of the CSF and MVI commands. 
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2.9 BACKUP AND RESTORE 

Volume II gives specific information on how to back up your system disk. It explains backup pro- 
cedures and differentiates among the following six commands: 

Disk Copy/Restore (DCOPY) 

Copy Directory (CD) 

Backup Directory (BD) 

Copy and Verify Disk (CVD) 

Copy Volume (CV) 

Backup Directory to Device (BDD) 

Briefly, DCOPY is the fastest but offers no disk compression. DCOPY can copy from tape to disk 
and vice versa, and from disk to disk. CVD and CV can only copy from disk to disk. The CVD and 
CV commands offer file compression and the capability of avoiding bad tracks. CVD and DCOPY 
require that the input disk and output disk be the same size and type. DCOPY requires that the 
destination disk and source disk have the same number of tracks, sectors per track, and bytes per 
sector even if there is an intervening tape copy. CV can copy between disks of different sizes and 
types. 

CD is a more general copy that copies disks of different types. It offers disk compression, selec- 
tion of which files to copy, and conversion of physical record length of files. BD and BDD copy the 
disk onto one sequential file, magnetic tape, or disk (or DSDD diskette). They can copy onto sev- 
eral tape or disk volumes if necessary. If you are backing up a disk onto several volumes, you must 
use BD or BDD. See Volume II for backup and restore instructions. 

2.10 BUILDING A CUSTOM DISKETTE OR TAPE TO USE WITH DISK BUILD 

You can produce a backup on tape or diskette for use with Disk Build that contains a custom sys- 
tem generation and your custom software. This can shorten the time it takes you to build a new 
system or recover from problems with your system disk if you have a system without any 
removable disks. This paragraph gives the details on what you need to include in the custom 
backup. 
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Your custom backup must contain the following system files: 

S$SDS$ 

S$PROC 

S$OVLYA 

S$LOADER 

S$PROGA 

S$IMAGES 

S$MVI 

The file S$SDS$ contains the assembler, the Link Editor, and programs from installation of lan- 
guage packages such as the COBOL compiler. If you do not need any of these functions on the 
system you are building, you may omit this file. 

S$PROC need only contain those command procedures necessary for operation of the system you 
are building and its applications. You can delete the command procedures for functions you do 
not need. 

S$OVLYA and S$LOADER must be present. 

S$PROGA need only contain those command processors necessary for operation of your applica- 
tions and the operating system. Volume II contains a table that shows what parts of S$PROGA are 
necessary for each of the standard DX10 command procedures. You can delete those command 
processors for the functions you do not need. However, it is wise to retain some functions needed 
for diagnosis of problems, such as ANALZ. Make a copy of S$PROGA; delete the tasks, proce- 
dures, and overlays not needed; and copy it to the disk to be backed up with CD. The BD command 
that creates the backup finishes the process of compressing the program file. 

The S$lMAGES file must contain the system image designated for use by the contents of the 
S$MVI file. The Modify Volume Information (MVI) processor creates S$MVI when it is executed on 
a disk that is initialized as a system disk, has all the system files on it, and is installed in the sys- 
tem (IV). The file can also be created by the Text Editor. See Volume II for more information on the 
MVI command. 

The Disk Build software takes a certain amount of space on the disk being built. Be sure the disk 
or directory you back up is small enough so the disk being built does not fill up during the restore 
directory process. 

NOTE 

The disk from which you copy to produce the backup should not 
contain any of the files that start with B$. The presence of any such 
file in the backup may cause the RD process of the Disk Build to 
return an error. 
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The Disk Build program attempts to run MVI even if errors occur during the RD process. However, 
if errors occur, it does not attempt to perform an IPL for the system it just built. At that point, you 
should not perform an IPL You can use the log-on sequence to run a skeleton SCI. Use a .SHOW 
.B$LISTRD SCI primitive to inspect the listing from RD. The error messages in that file allow you to 
determine what the problem is. 

If the system builds successfully but an IPL cannot be performed, the most likely cause is that the 
S$MVI file is either missing or specifying the wrong system image. 

2.11 SYSTEM FILES 

DX10 maintains specific system files related to DX10 operations in each disk volume as a part of 
system overhead. System files allow the operating system to function. 

Ordinarily, you do not want to back up these files because they are already on the system disk and 
they are not often changed or easily built. Therefore, select the NOSYSFILE option on the CD and 
BD commands to exclude these files. However, if you are building a system disk or generating an 
alternative system disk to use with a specific application, you want to be sure they are included in 
the copy procedure. Accept the default. 

Because DX10 requires these files, do not change the characteristics of any of them and do not 
alter the contents of the first six listed except as patched by released patch batch streams. DX10 
system files include the following: 

System program file .SSPROGA 

System image file .S$IMAGES 

Overlay file .S$OVLYA 

Roll file .S$ROLLA 

System crash file .S$CRASH 

System loader .S$LOADER 
Diagnostic file , .S$DIAG 

SCI procedure directory .S$PROC 

Background terminal communications area .S$BGTCA 

Foreground terminal communications area .S$FGTCA 

Background terminal local file .S$BTLFXX 

Foreground terminal local file .S$FTLFXX 

Terminal library .S$TCALIB 

Volume directory .VCATALOG 

LP$X directory .S$PRINT 

System log file 1 .S$$SLG1 

System log file 2 .S$$SLG2 

where: 

S$ designates system files. 

XX is the terminal identification number. 

You can initialize system log files during the DX10 loading and start-up procedure by entering the 
Initialize System Log (ISL) command. The ISL command initializes the two log files that store 
device errors, input/output (I/O) errors, task errors, and messages generated by user programs. 
The command also permits selection of tasks to process the log file entries. 
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Do not name user files with file names starting with S$. This nomenclature is reserved for system 
files cataloged directly in the volume directory .VCATALOG. Following this convention aids you in 
avoiding any conflict regarding file pathnames. 

Under DX10, an operational system disk must include a program file, overlay file, roll file, loader 
file, and a system image file. These files are built from a software kit or are provided in an opera- 
tional DX10 system disk provided with the system. You can maintain primary and secondary ver- 
sions of the program file, image file, and overlay file by using the MVI command to modify disk 
volume information (refer to paragraph 2.13). If you maintain more than one system program file, 
image file, loader file, and overiay file under different names on a system disk, you can switch to a 
specific version suited to your applications. 

• System program file — The system program file <S$PROGA) contains system programs 
and optionally may contain user programs. 

• System image name — The name of the system image in the S$IMAGES file that con- 
tains the memory resident parts of DX10. 

• System overiay file — The system overlay fiie (S$OVLYA) is a relative record file that 
contains disk-resident overlays of DX10. 

• Roll file — The roll file (S$ROLLA) is used by DX10 to roll out disk-resident tasks. Roll 
files are created with the CSF command. 

• System crash file — The system crash file (S$CRASH) is used by DX10 to save the total 
memory image following a system crash. The system crash file must be as large as the 
whole memory. The default size is 64K words. The CSF command creates the system 
crash file; it uses the sector size specified in the command. The system crash file may 
be deleted; however, then it is not possible to save system crash information. 

• System loader file — The system loader file (S$LOADER) is an image file containing 
code that loads the DX10 operating system from the system image file. The fiie name 
must be eight characters in length. 

• Diagnostic file — The diagnostic file (S$DIAG) is created by the INV command. It is a 
read-only file containing pseudorandom data patterns used for system verification by 
diagnostic programs. This file occupies exactly one disk cylinder and is located as 
close as possible to the disk spindle. (If the closest cylinder has a bad track, the next 
closest is used, and so on. S$DIAG always occupies an error-free cylinder.) 

• SCI procedure directory — The SCI procedure directory (S$PROC) contains SCI proce- 
dures and has a maximum of 457 entries. 

• Output spool files — The directory S$PRINT contains the output spool files for the 
pseudo-devices LP$1 through LP$9, which hold output for printer devices LP01 through 
LP09. The CSF command creates the directory. 
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System log files 1 and 2 — The system log files (.S$SLG1 and .S$SLG2) are queues of 
system log messages that provide information about device errors, abnormal task termi- 
nation, user messages, system log processor messages, memory errors, errors in mem- 
ory cache, and statistics. Refer to Volume VI for more information on the system log. 

Writable control storage (WCS) file — The WCS file contains predefined XOP instruc- 
tions. Refer to the 990/99000 Assembly Language Reference Manual for a detailed 
description of the WCS file. The WCS file is for use on 990/12 computers only. 

SCI generates and maintains the following files as required by DX10. SCI-reiated files are automat- 
ically created, maintained, and deleted as required. You should not alter or delete these files. 

Background terminal communications area file — The background terminal communi- 
cations area file (S$BGTCA) is used by SCI to control background program processing. 

Foreground terminal communications area file — The foreground terminal communica- 
tions area file (S$FGTCA) is used by SCI to control foreground program processing. 

Background terminal local file — The background terminal local file (S$BTLFXX) is used 
by SCI as an output file for background processes at the terminal level. 

Foreground terminal local file — The foreground terminal local file (S$FTLFXX) is used 
by SCI as an output file for foreground processes at the terminal level. 

Terminal library — The terminal library (SSTCALIB) contains data or user IDs defined to 
the system. 

VCATALOG — VCATALOG is the master directory for a volume. 

2.12 MODIFYING DISK VOLUME INFORMATION 

Unless you already have a running version of DX10 and need to use the Modify Volume Informa- 
tion (MVI) command to recognize the newly built system as the primary system image, you need 
not use the MVI command before going on to Section 3, system generation. 

You can change disk volume information by using the MVI command. Under MVI, you can list 
and/or change specific files and all files and volume information within those files. To terminate 
MVI, enter Q. For a detailed description of the MVI command, see Volume II. 

2.13 MODIFYING INITIAL STATE SPECIFICATIONS 

For security reasons, you will probably want to control the log-on specifications of your system. 
Whether you modify these specifications before or after system generation is a matter of personal 
choice. 
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The DX10 user interface requires that certain characteristics relative to each terminal in the sys- 
tem be defined for ail terminals. SCI allows specific terminals to operate with predetermined char- 
acteristics as follows: 

Terminal status (device ON/OFF) 

Terminal operational mode (TTY/VDT) 

Terminal operational mode default (TTY/VDT) 

Terminal log-on specification (YES/NO) 

Terminal privilege level (0 through 7) 

You can modify these characteristics by using the commands described in the following 
paragraphs. 

2.13.1 Initial States 

The initial state of DX10 terminals after IPL is the following: 

All terminals are on. 

No terminal requires log-on. 

TTY terminals are in TTY mode. 

VDT terminals are in VDT mode. 

All terminals are assigned the highest privilege level. 

2.1 3.2 Modification Strategy 

Depending on the requirements of each DX10 installation, the system programmer may decide to 
assign users and specific terminals on a system a varying level of access privilege and unique 
user ID assignments. You can also specify the mode of operation (TTY or VDT) for each terminal. 
Through the Modify Terminal Status (MTS) command, you can initialize specific assignments for 
terminal use and access. You can redefine terminal specifications each time you do an IPL. We 
recommend that you put all VDTs in VDT mode and all 733/743 type terminals in TTY mode as the 
default mode. 

DX10 also provides you the capability of identifying a particular system user. Through the fol- 
lowing commands, the system programmer can assign user ID, passcode, and privilege code 
specification: 

AUI —Assign User ID 
MUI— Modify User ID 
DUI — Delete User ID 

See Volume II for descriptions and examples of these commands. 
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2.1 3.3 Modifying the IS Command 

The IS command is an SCI command that automatically calls several commands and performs 
several functions related to initializing DX10. 

IS is a general purpose initialization command designed to be modified by each DX10 installation. 
We advise the person coordinating system use to employ the IS command in generating a specific 
configuration with DX10. 

The command stream initialized by the IS command includes the following SCI commands: 

• Initialize Date and Time (IDT) 

• Initialize System Log (ISL) 

• Modify Terminal Status (MTS) 

• Modify LUNO Protection (M LP) 

For descriptions and examples of these commands, see Volume II. 

The following procedure describes how to facilitate modification of the IS command for custom 
terminal configurations. 

1. Issue the Copy/Concatenate (CC) command to create a copy of the file .S$PROC.IS. 
Enter .S$PROC.IS in response to the INPUT ACCESS NAME prompt and 
.SSPROC.ISCOPY (the pathname of the copy) as the OUTPUT ACCESS NAME. 

2. Text edit the procedure by issuing the Initiate Text Editor (XE) command with the path- 
name of .SSPROC.ISCOPY. given as the FILE ACCESS NAME. (Refer to the DX10 Operat- 
ing System Text Editor Manual (Volume IV).) 

3. Using the Text Editor, add an MTS command to the procedure for each terminal, thereby 
defining terminal characteristics at the entry of the IS command. You can also add 
appropriate IV commands and Assign Global LUNO (AGL) commands. 

4. Terminate the text edit session, specifying .SSPROC.ISCOPY as the OUTPUT ACCESS 
NAME. 

5. Test the modified IS command by issuing the ISCOPY command. If the command works 
satisfactorily, issue a CC command, specifying .S$PROC.ISCOPY as the INPUT 
ACCESS NAME and .S$PROC.IS as the OUTPUT ACCESS NAME. With this action, the 
modified command procedure is installed as the standard IS procedure. 
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3.1 SYSTEM GENERATION 

The DX10 operating system's purpose is to manage the complex and varied operations of a com- 
puter system. To accomplish this, DX10 must obtain information about the computer's physical 
and logical makeup (its parameters). Furthermore, DX10 must be directed to process these para- 
meters into a form that is more suited to efficient management of the computer system. These 
processes of obtaining and processing the computer's parameters constitute system generation. 

Generating a system involves the following stages: 

• Preexecution considerations 

• Execution of the Execute System Generation Utility (XGEN) command, during which you 
provide DX10 the necessary parameters of the computer system 

• Execution of the Assemble and Link Generated System (ALGS) command 

• Execution of the Patch Generated System (PGS) command 

• Execution of the Test Generated System (TGS) command 

• Execution of the Install Generated System (IGS) command 



NOTES 

Hexadecimal numbers are preceded by a left angle bracket (>) 
throughout this manual. Numbers without the left angle bracket are 
assumed to be decimal. Follow this convention when entering 
numbers to DX10 through the keyboard. 

Also, the names of keys are generic key names throughout this 
manual. In some cases, the names on the keycaps of the terminals 
match the generic key names, but in many cases they do not. 
Appendix A contains a table of key equivalents to identify the spe- 
cific keys on the terminal you are using. Drawings that show the 
layout of the keyboard of each type of terminal are also included. 
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3.2 PREEXECUTION CONSIDERATIONS 

Before issuing the XGEN command, consider two factors: 

• Devices to be added in the future 

• Ready knowledge of the computer system parameters that you must provide during the 
execution of the System Generation utility 

NOTE 

Make sure you read the object installation documents for any com- 
munications product that you plan to install on the system. 

If you anticipate adding a new device in the near future, you may want to include the device during 
system generation to avoid regenerating the entire system just to include that one device. Use the 
Modify Device State (MDS) command to place the device offline until you physically install it. If 
you should use this technique, the system software may require that the device's controller board 
be installed in the chassis. In addition, some devices cannot share interrupts. Refer to paragraph 
3.2.3 on interrupts for a discussion of this requirement. 

Before you begin system generation, fill out the configuration chart for your system so you can 
respond readily to the prompts in the device definition portion of the System Generation utility. 
The following paragraph describes basic system configurations. 

3.2.1 Base System Configurations 

Tl supports a base system configuration with multiple disk drives and at least one interactive 
device, such as a 931 video display terminal (VDT). The base system configuration, stored in 
.S$IMAGES, requires that the supported devices be physically configured so that it conforms to 
the minimum configuration shown in the following tables and figures. 

Table 3-1 shows the base system configuration supported by the DX10 system shipped on hard 
disk or on flexible diskette build media. Table 3-2 shows the base system configuration supported 
by the DX10 system shipped on magnetic tape build media. See Section 2 for instructions on 
building a system from the media shipped to you from Tl. 

Figures 3-1, 3-2, and 3-3 show the suggested base hardware configuration for each of the indi- 
cated chassis. Tl suggests that your computer hardware be configured to match that in the 
figures, with your other devices added to it. This enables you to buiid a DX10 system in the future 
with a minimum of configuration changes. Figure 3-1 shows the configuration for the 990A13 
13-slot chassis. The Business System 600 and 800 use this chassis. The footnotes indicate the 
various combinations that can appear in a system configured by Tl. The system shipped from the 
Tl factory is capable of performing the system build, whichever media you have. You need to 
examine the configuration chart for your system to determine what devices and parameters to use 
in executing system generation. Figure 3-2 shows the configuration for the 990 13-slot chassis. 
Figure 3-3 shows the configuration for the 990 17-slot chassis. (Note that in these figures the right 
angle bracket (> ) precedes a hexadecimal value.) 
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NOTE 

Systems are shipped with the configuration chart attached to the 
computer chassis. Update the chart whenever you add or remove 
devices from the system. 



Table 3-1 . Base System Configuration for DX1 on Disks 



Device 



TILINEor 
CRU Address 



Interrupt 



Devices Supported 



Disk 
VDT 



>F800 
>F820 

>1700 
>0100 
>F980 



13 
9 

8 
10 
11 



3 Drives 
1 Drive 

931 VDT/940 EVT 

911 VDT 

931 VDT/940 EVT on channei 



Table 3-2. Base System Configuration for DX1 on Magnetic Tape 



Device 


TILINEor 
CRU Address 


Interrupt 


Devices Supported 


Disk 
Tape 
VDT 


>F800 

>F880 

>1700 
>0100 
>F980 


13 

9 

8 

10 
11 


4 Drives 

1 Drive 

931 VDT/940 EVT 

91 1 VDT 

931 VDT/940 EVT on channei 



I 



946250-9705 



Change 1 



3-3 



System Generation 







LEFT SIDE (PI) 






RIGHT SIDE (P2) 






SLOT 


DEVICE 


CRU 
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BASE 


TILINE 


INTER- 
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>2E0 




6 
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3 
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10 
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>280 




8 
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1 2 
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>220 




7 
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>200 
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6 




>1E0 




1 1 
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SEE 
NOTE t 
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>1A0 




9 


7 
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1 3 


SEE 
NOTES 
2 AND 
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>160 
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>140 




9 


SEE 
NOTE 4 
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>120 




8 


9 


9 1 1 VDT 


>100 




10 


SEE 
NOTE 5 


to 




>0E0 




1 2 


10 




>0C0 




1 1 




1 1 




>0A0 




3 


1 1 




>080 




7 




12 




>060 




14 


1 2 




>040 




4 




13 




>020 




1 5 


13 




>000 




6 



2283055 



NOTES : 

(1) SOME STANDARD OPTIONS FOR SLOT 7 ARE AS FOLLOWS: 

• A o F J& L »2 ( A .1 D - T1L * N E DISK CONTROLLER AT ADDRESS >F800 , INTERRUPT 
1 3 ON P2 SIDE . 

• S.JIbi^f JSI!l , i , i ,e 5^. L BUS INTERFACE (TPBI) BOARD FOR TAPE IN P1 AT 
TJLV^JL^-PSISS >F880 . INTERRUPT 9 AND FOR DISK IN P2 AT TILINE 
ADDRESS >F800, INTERRUPT 13 (FOR EXAMPLE, WD800). 

• A TPBI BOARD FOR DISK IN P1 AT TJUNE ADDRESS > F820 , INTERRUPT 

?-AS C UE95.£'S K ,N P2 AT TILINE ADDRESS >F300. INTERRUPT 13 
(FOR EXAMPLE, WD500). 

(2) SOME STANDARD OPTIONS FOR SLOT 8 ARE AS FOLLOWS: 

• A FULL BOARD FOR DISK AT TILINE ADDRESS >F820, INTERRUPT 9. 

• A FULL BOARD FOR TAPE AT TILINE ADDRESS >F880 , INTERRUPT 9. 

(3) THE P2 SIDE IS USER PROGRAMMABLE TO BE INTERRUPT 9 OR 14. 

(4) ^S,?oTL C l N » F ^ R ,J HE P1 S,DE OF SL0T 9 IS A 931 VDT OR 940 EVT AT 
n5 U A^fe«PP5f.fS.-^. ,70 °' INTERRUPT 8. THIS IS A CI402 CONTROLLER 
ON A SYSTEM WHERE THE CPU IS NOT A /10A. 

^ 5) « D S J AN P AR «3. ^.fJISH TOR SLOT 10 IS A 931 VDT OR 940 EVT ON A CI403 
OR CI404 AT TILINE ADDRESS > F980 . INTERRUPT 11 , CHANNEL 0. 



Figure 3-1 . Base System Configuration for 990A1 3 1 3-Slot Chassis, Business System 600/800 
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/9"S AN OPTION FOR THE PI SIDE OF SLOT 9 IS A 931 VDT OR 940 EVT AT CRU 
( ' BAS^ ADDRESS >1 700 . INTERRUPT fl- THIS IS A CI402 CONTROLLER ON A 
SYSTEM WHERE THE CPU IS NOT A /10A. 
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Figure 3-2. Base System Configuration for 990 1 3-Slot Chassis 
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Figure 3-3. Base System Configuration for 990 1 7-Slot Chassis 



3-6 



946250-9705 



System Generation 



3.2.2 Determining CRU Addresses 

The communications register unit (CRU) is a serial data bus used by slower devices, such as key- 
board devices and line printers. When defining one of these devices, you must specify its CRU 
base address. A device's CRU base address is determined by the position of its controller board in 
the chassis. 

Note that a controller board can be either full-size, filling an entire slot, or half-size, filling either 
the left or right half-slot. A half-size board inserted in a half-slot uses the CRU base address of that 
half-slot. For example, a half-size board in the left-hand half-slot of slot 14 in Figure 3-5 uses CRU 
base address >0E0. 

Most full-size CRU device controller boards actually implement two separate control circuits on 
the two halves of a single board. The left and right halves of the board use the left and right CRU 
base addresses, respectively. For example, a 911 VDT controller board can be inserted in slot 9 of 
Figure 3-4. The control circuit on the right side of the board controls a single 911 VDT and uses 
CRU base address > 100. The control circuit on the left side of the board controls another 91 1 VDT 
and uses CRU base address > 120. 

Some full-sized controller boards use a single circuit to control several units of a particular kind of 
device. Such boards use only the right-hand (P2) CRU base address of that slot. For example, an 
FD800 serial flexible disk drive controller board in slot 11 controls one or more drives, but only 
uses CRU base address > 080. 

3.2.2.1 Arrangement of CRU Base Addresses in a Chassis. The CRU base addresses in a chas- 
sis begin at >000. Each following CRU base address is greater than the preceding CRU base 
address by > 020. Figure 3-4 shows how the CRU base addresses are arranged within the 13-slot 
chassis starting at the highest numbered slot, which is slot 13. CRU base address >000 is 
assigned to the right-hand (P2) half-slot of slot 13. The next CRU base address, > 020, is assigned 
to the left-hand (P1) half-slot of slot 13. The next CRU base address, >040, is assigned to the P2 
half-slot of the second highest numbered slot, which is slot 12. This pattern continues until the 
maximum CRU base address, > 2E0, is reached. CRU devices cannot be installed in slots without 
a CRU base address. These slots are reserved for other boards, such as central processing unit 
(CPU) and memory boards. 

3.2.2.2 CRU Base Addresses for a 17-Slot Chassis. The arrangement of CRU base addresses in 
a 17-slot chassis is similar to that of the 13-slot chassis. Figure 3-5 shows the arrangement of CRU 
base addresses in a 17-slot chassis. 
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Figure 3-4. CRU Base Addresses for 990 and 990A1 3 1 3-Slot Chassis 
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Figure 3-5. CRU Base Addresses, 17-Slot Chassis 



946250-9705 



3-9 



System Generation 



3.2.2.3 CRU Addresses in Expansion Chassis. The CRU base addresses in an expansion chas- 
sis are arranged in the same manner as in the main chassis except that the CRU base addresses 
are offset by a multiple of > 400, depending on the sequential position of the expansion chassis. 
Table 3-3 lists the values to be added to the CRU base addresses for each expansion chassis. 

Table 3-3. CRU Base Address Offsets for Expansion Chassis 



Expansion Chassis Add to Base Address 



1 >0400 

2 > 0800 

3 >0C00 

4 >1000 

5 >1400 

6 >1800 

7 >1C00 



Figure 3-6 shows the CRU base addresses for a 13-slot chassis used as the first expansion chas- 
sis. Notice that slot 1 has not been assigned an address. This position is always occupied by a 
buffer board (the CRU expander board). 

3.2.3 Interrupt Levels 

During system generation, you must specify the hardware interrupt that each device generates. 
The location of the controller or interface board in the chassis determines the interrupt level. Fig- 
ure 3-7 shows the standard interrupt assignments for a 990A13 13-slot chassis. Figure 3-8 shows 
the standard interrupt assignments for a 990 13-slot chassis. The interrupt levels for a 13-slot 
chassis are determined by the positions of jumper wires on the system interface board, which is 
attached to the rear of the 13-slot chassis. The jumper wires are inserted into a molded plastic 
connector plugged into the backboard above slot 1. Do not attempt to change the position of 
these wires or the connector. The 990A13 chassis uses an etched or programmable card that 
plugs into the system interface board above slot 1. 

3.2.3.1 Interrupts for Devices in Expansion Chassis. If a device is configured in an expansion 
chassis, the device uses the same interrupt used by the expansion card in the main chassis. When 
a device in an expansion chassis is defined during system generation, you are prompted for an 
interrupt level. Respond with the level assigned to the expansion card for the expansion chassis. 
You are also prompted for the device's expansion position. Respond to this prompt with the inter- 
rupt level assigned to the device's position within the expansion chassis. Interrupt levels within a 
13-slot expansion chassis are the same as those within a 13-slot main chassis. Similarly, the inter- 
rupt levels within a 17-slot expansion chassis are the same as those within a 17-slot main chassis. 
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Figure 3-6. CRU Base Addresses, 1 3-Slot Expansion Chassis #1 
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Figure 3-7. 990A1 3 Interrupt Assignments, 1 3-Siot Chassis 
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Figure 3-8. Interrupt Assignments, 13-Slot Chassis 
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3.2.3.2 Devices Sharing Interrupts. When configuring your system, observe the following 
guidelines: 

• T1LINE devices never share interrupts. However, the CI403 and CI404 communications 
controllers can share interrupts between each other. 

• CRU devices can share interrupts. However, some combinations may not be designed to 
work, and others may work only with low-speed devices. You should not share interrupts 
for high-speed devices. 

• A communication device performs best if it does not share an interrupt. This is strongly 
recommended. 

• Interrupts cannot be shared between any device and a CRU expander card. It is best 
not to share the interrupts for CARD1 and CARD2, the two interrupts for total CRU 
expansion. 

Frequently, several CRU devices are assigned the same interrupt during system generation or the 
same position (interrupt) in an expansion chassis. The device controllers may be absent from the 
chassis and generated with shared empty slots. However, some combinations with shared empty 
slots may not be designed to work. Refer to Section 4 to determine which interrupts are giving you 
problems. Some combinations may only work with low-speed devices. You should not share an 
empty slot for high-speed devices. 

On 990 Models 20 and 30, the 17-slot chassis used as the main chassis in the 990/12 CPU has sol- 
dered connections that determine the interrupt levels. Figure 3-9 shows the standard interrupt 
level assignments for a 17-slot chassis. 

3.2.4 T1LINE Addresses 

TILINE is a high-speed, bidirectional, 16-bit data bus. It serves as a path for communication 
between all high-speed elements in the system. The CPU, main memory, and high-speed periph- 
eral devices are directly connected to the TILINE. TILINE peripheral devices include disk drives, 
magnetic tape transports, some communications ports, double-sided, double-density (DSDD) 
diskette drives, and asynchronous multiplexers. 

You must supply the TILINE address when defining TILINE devices. This address, which the 
hardware converts to a memory address, is determined by the switch settings on the controller for 
the TILINE device. You should not alter these switches since the bits set by them differ from one 
type of controller to another. Figure 3-1, Figure 3-2, and Figure 3-3 show typical TILINE address 
assignments in 13- and 17-slot chassis. The configuration label attached to your computer's chas- 
sis records the TILINE addresses as they were set up when your computer was manufactured. 
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Figure 3-9. Interrupt Assignments, 17-Slot Chassis 
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Table 3-4 lists the conventional T1LINE assignments. We recommend that your system follow this 
pattern. 

If you put a CI403/CI404 controller in an expansion chassis, a TILINE coupler must be present, and 
all CI403/CI404 controllers must have their interrupts wired through the TILINE coupler. You gener- 
ate them to have the interrupt level where the TILINE coupler is plugged into the main chassis. 



Table 3-4. Recommended TILINE Address Assignments 



TILINE Address 


>FB00 


>FB04 


>FB08 


>FB10 


>FB14 


>FB18 


> F800 


>F810 


>F820 


>F830 


>F840 


>F850 


>F860 


>F870 


>F880 


>F890 


>F900 


>F910 


>F920 


>F930 


>F940 


>F950 


>F980 


>F990 


> F9A0 * 



Device Type 



Controller Number 



Memory Controller 



Cache Memory Controller 



Disk Controller 



Tape Controller 



Communication Controller 



1 (System Disk) 
2 
3 
4 
5 
6 
7 
8 



CI403/404 



1 
2 
3 

Note: 

* You can add additional controllers after this one. Add >10 to this address to obtain the 
address of each subsequent controller. 
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3.3 GEN990 SYSTEM GENERATION UTILITY 

As discussed in preceding paragraphs, DX10 must obtain the operating parameters of a computer 
system in order to control that system. When GEN990 executes, it displays prompts which ask you 
for these parameters. You aid GEN990 in the definition of the computer system by supplying the 
values of these parameters. Then, at your direction, GEN990 can build the data files that are used 
by the remainder of system generation. 

GEN990 requires extensive interaction with you. The parameter values that you supply must 
reflect your computer's configuration accurately. Consequently, GEN990 is more vulnerable to 
error than the remaining parts of system generation, which require relatively little human input. 
The following paragraphs provide a description of GEN990. We recommend that you read the fol- 
lowing description of GEN990 and gather the required parameter values before attempting to exe- 
cute GEN990 (also called system generation). 

The following paragraphs discuss these topics: 

• Files created and used by GEN990 

• GEN990 modes of operation (command and inquiry) 

• GEN990 commands 

3.3.1 Files Created and Used by GEN990 

The GEN990 process uses your responses to the parameter prompts and the contents of various 
data files to produce a new system. These files are stored in the directories called .S$SYSGEN 
and .PATCH, which can be on any disk currently installed in the system. Identify the disk where 
they are located by responding to the first GEN990 prompt DATA DISK/VOLUME. 

The GEN990 utility produces a directory called .S$SYSGEN.< output> , where <output> is the 
name you call the system, entered in response to the third system generation prompt, OUTPUT 
CONFIGURATION. In addition to the directory, GEN990 builds the following files, which are cata- 
loged under the new directory: 

• BATCHSTM — A batch stream of System Command Interpreter (SCI) commands used 
by the ALGS command (see paragraph 3.5). 

• CONFIG — The configuration file for the new system. The configuration file contains 
the parameter values given in response to GEN990 prompts. You can read and print this 
sequential file, but under no circumstances should you edit it. 

• D$SOURCE — A file containing the assembly language source code for the data base 
module (D$DATA) of the new system. 

• LINKSTRM — A file containing ail of the Link Editor commands necessary to link ail 
parts of the new system together. 
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3.3.2 GEN990 Modes of Operation 

GEN990, the interactive System Generation utility invoked by the XGEN command, can operate in 
either the command or inquire mode. In the inquire mode, GEN990 prompts you for the parameter 
values required to define the system configuration. In the command mode, you can list, change, or 
delete portions of the configuration created in the inquire mode. 

NOTE 

In either the command or inquire mode, GEN990 understands com- 
mands and data that are entered in uppercase only. Commands and 
data entered in lowercase are misinterpreted. 

3.3.2.1 Inquire Mode. GEN990 begins execution in the inquire mode. In the inquire mode, 
GEN990 prompts you for parameters of the system being generated. You supply the parameter 
values of the system being generated. You can enter the inquire mode from the command mode by 
responding to the COMMAND prompt with INQUIRE. 

3.3.2.2 Command Mode. You can enter the command mode at any time during the execution of 
GEN990 by pressing the Command key on your terminal. When GEN990 is in the command mode, 
it prompts you to enter a command by displaying the following: 

COMMAND? 
Respond by entering one of the GEN990 commands listed in Table 3-5. 

3.3.3 GEN990 Commands 

Table 3-5 lists the legal commands that you can issue to GEN990 from the command mode. Table 
3-6 lists the legal commands that you can issue from the inquire mode. The following paragraphs 
describe the commands and their uses. 
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Table 3-5. Legal Commands in GEN990 Command Mode 



Command 



BUILD 



CHANGE 



DELETE 



INQUIRE or HELP 



LIST 



STOP 



Result 



This command enables you to initiate the build 
sequence to build the configuration, source, 
and Link Editor control files, and terminate 
GEN990. You can also do this in inquire mode. 

This command enables you to change the 
value of a specified parameter. You can enter 
CHANGE only from the command mode. 

This command enables you to delete a device 
or supervisor call (SVC) from the system gener- 
ation. 

These commands return GEN990 to inquire 
mode from the command mode. GEN990 
prompts you to define the next parameter with 
NEXT. 

This command causes GEN990 to display the 
parameter values of the current configuration. 

This command terminates GEN990. You can 
also issue STOP in the inquire mode. 



Table 3-6. Legal Commands in GEN990 Inquire Mode 



Command 



BUILD 

DVC or GENERATE 

STOP 

SVC 

WHAT or? 



Result 



This command enables you to initiate the Build 
sequence to build the configuration, source, 
and Link Editor control files, and terminate 
GEN990. 

These commands cause GEN990 to prompt 
you for a DEVICE TYPE. 

This command terminates GEN990. You can 
also issue STOP in the command mode. 

This command causes GEN990 to prompt you 
for the parameters for an SVC. 

This command causes GEN990 to display an 
explanation of the parameter prompted. 



946250-9705 



3-19 



System Generation 



3.3.3.1 BUILD Command. Refer to the entry for the STOP command. 

3.3.3.2 CHANGE Command. Use the CHANGE command to modify a previously defined value. 
You can legally issue the CHANGE command only from the command mode, which you enter by 
pressing the Command key. When you enter CHANGE, GEN990 displays the following prompt on 
the terminal screen: 

PARAMETER TO BE CHANGED? 

If you want to change a system parameter (rather than a device parameter), enter the parameter 
keyword (the name of the parameter) that you wish to change, such as TIME SLICING ENABLED. 

Instead of writing the entire parameter keyword, you can enter an abbreviation of the parameter 
keyword. DX10 interprets abbreviations using the Near Equality algorithm. The three rules for 
abbreviating keywords as implemented by the Near Equality algorithm are the following: 

• The abbreviation and the keyword must begin with the same letter. 

• All letters in the abbreviation must appear in the keyword in the same order of 
occurrence. 

• The first letter following a blank in the keyword must match the first unmatched letter in 
the abbreviation. 

For example, both TSE and TIME are legal abbreviations for TIME SLICING ENABLED. 

Be sure that an abbreviation is unique to a keyword. For example, if you entered INTER as an 
abbreviation for the parameter keyword INTERTASK?, DX10 would interpret INTER as the keyword 
INTERRUPT DECODER?. Similarly, although the abbreviation INTERT appears to stand for 
INTERTASK?, DX10 interprets INTERT to be INTERRUPT DECODER?. 

For a more detailed discussion of the Near Equality algorithm, refer to Volume III. 

To change a parameter of a particular device, respond to the prompt PARAMETER TO BE 
CHANGED? with DVC. In the CHANGE command, GEN990 responds to DVC with the following 
prompt: 

DEVICE NAME? 

Respond to this prompt with the device name of the previously defined device, for example, DS02 
or ST04. GEN990 then displays the prompt DEVICE TYPE. Enter the type of device that you are 
changing, such as DS or VDT. 

If you press the Return key without entering a device type, then GEN990 deletes the device sup- 
plied to the prompt DEVICE NAME. 



3 " 20 227659-9701 



System Generation 



The following example demonstrates the way to change the access type of LP02, showing the 
prompts from GEN990 and appropriate responses. After you enter the command mode by pressing 
the Command key on your terminal, GEN990 prompts you for a command: 

COMMAND? CHANGE 

PARAMETER TO BE CHANGED? DVC 

DEVICE NAME? LP02 

DEVICE TYPE? LP 

CRU ADDRESS? (> 60) 0080 

ACCESS TYPE? (FILE) RECORD 

9902 INTERFACE? (NO) 

PRINT MODE? (SERIAL) 

EXTENDED? (NO) 

TIME OUT? (60) 

INTERRUPT? (6) 

The following example demonstrates the way to change an existing SVC, USVC2, to another SVC, 
USVC9. Note that the object code for USVC9 is already in the file TESTER.USVC9. The example 
includes the prompts from GEN990 and appropriate responses. After you enter the command 
mode by pressing the Command key on your terminal, GEN990 prompts you for a command: 

COMMAND? CHANGE 
PARAMETER TO BE CHANGED? SVC 
SVC ENTRY NAME? USVC2 
SVC? USVC9 
FILE7.TESTER.USVC9 
BYTES? (1)20 

3.3.3.3 DELETE Command. Use the DELETE command to remove a device or SVC from the cur- 
rent configuration. When you issue the DELETE command, GEN990 prompts you for an ENTITY 
TO BE DELETED. Respond with either DVC, if you want to delete a device, or SVC if you want to 
delete an SVC. 

The following example demonstrates the deletion of a line printer, LP03, showing the prompts 
from GEN990 and the appropriate responses. 

After you enter the command mode by pressing the Command key, GEN990 prompts you for a 
command: 

COMMAND? DELETE 
ENTITY TO BE DELETED? DVC 
DEVICE NAME? LP03 
COMMAND? 
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When a device is deleted, GEN990 reorders the device names of similar devices to maintain an 
unbroken numerical sequence. The following chart demonstrates this: 

Before deletion of LP03 After deletion of LP03 

LP01 remains LP01 

LP02 remains LP02 

LP03 deleted 

LP04 becomes LP03 

LP05 becomes LP04 

The following example demonstrates the deletion of the SVC USVC3, showing the prompts from 
GEN990 and the appropriate responses. After you enter the command mode by pressing the 
Command key, GEN990 prompts you for a command: 

COMMAND? DELETE 
ENTITY TO BE DELETED? SVC 
SVC ENTRY NAME? USVC3 
COMMAND? 

3.3.3.4 DVC Command. Issue the DVC command from the inquire mode to define a device. 
When the DVC command is issued, GEN990 prompts you for a DEVICE TYPE. Respond with a 
device mnemonic, such as ST, LP, or DS. GEN990 then prompts you for appropriate parameter 
values. Numerous examples are provided in paragraph 3.4.5. 

3.3.3.5 INQUIRE and HELP Commands. Issue either the INQUIRE command or the HELP com- 
mand to return GEN990 to the inquire mode from the command mode. After receiving the INQUIRE 
command, GEN990 displays the following prompt: 

NEXT? 

3.3.3.6 LIST Command. The LIST command can only be issued from the command mode. The 
LIST command causes GEN990 to list the value of ALL parameters specified and their values. 
When the LIST command completes its display, GEN990 remains in the command mode and dis- 
plays the COMMAND prompt. 

NOTE 

If you issue the LIST command at a VDT, the list of parameter val- 
ues rolls up from the bottom of the screen until each row of the 
screen contains an entry. To advance the display, press the Return 
key. If you want a permanent hard-copy list of your configuration, 
you need to use the Print File (PF) command to print the CONFIG 
file. 
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3.3.3.7 STOP and BUILD Commands. Issue either the STOP command or the BUILD command 
to terminate GEN990. Before terminating, GEN990 displays the following prompt: 

BUILD? (YES) 

If you want GEN990 to build the system generation files based on the data you have supplied, 
accept the default value of YES by pressing the Return key. When you enter YES, GEN990 begins 
to process the configuration parameters that you supplied. This processing requires a certain 
amount of time/depending on the number and kind of devices included. Throughout this process- 
ing, GEN990 displays the following messages informing you of its status: 

CONFIGURATION FILE SAVED 

D$DATA SOURCE FILE IS NOW BEING BUILT 

THE LINK EDIT COMMAND STREAM SOURCE FILE IS BEING BUILT 

BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT 

SYSGEN COMPLETE 

GEN990 TERMINATED 

If you do not want to build the system files at this time, enter NO and press the Return key. 

GEN990 then displays the following prompt: 

DO YOU WANT TO SAVE THE CONFIGURATION FILE? (NO) 

If you want to discard the parameters that you have entered and abort the system generation ses- 
sion, accept the default of NO by pressing the Return key. If you want to save these parameters in 
the CONFIG file, then enter the response YES and press the Return key. The following message 
appears: 

CONFIGURATION FILE SAVED 

After you respond to the above prompts, GEN990 displays the following message: 

SYSGEN COMPLETE 
After a few seconds, GEN990 replaces the above message with the following message: 

***** GEN990 TERMINATED ***** : 
Press the Command key to return to SCI. 

3.3.3.8 SVC Command. Issue the SVC command from the inquire mode to include user-written 
SVC processors with the generated operating system. Refer to paragraph 3.4.6 for a description of 
an SVC and a list of parameters. 

3.3.3.9 GEN990 WHAT Command. Issue the WHAT command (or a question mark (?)) to obtain 
an explanation of the most recently displayed prompt. If you issue the WHAT command in 
response to a parameter prompt by GEN990, GEN990 displays the explanation and reprompts the 
same parameter. For most parameters, two levels of explanation are available; that is, WHAT can 
be asked twice for the same parameter. The first issue of WHAT displays an abbreviated explana- 
tion and the second displays an expanded explanation. 
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3.4 EXECUTING GEN990 

You initiate GEN990 after you perform an initial program load (IPL) and initialize the system. (Vol- 
ume II describes a simplified IPL procedure. The ROM Loader User's Guide describes the IPL pro- 
cedure in detail.) Initiate GEN990 by issuing the XGEN command at your terminal. The following 
prompts immediately appear at your terminal: 

EXECUTE AUTO-SYSGEN 

DATA DISK/VOLUME: 

INPUT CONFIGURATION: 

OUTPUT CONFIGURATION: 

Respond to the prompt DATA DISK/VOLUME with the device name or volume name of disk drive 
that stores the system generation directories S$SYSGEN and PATCH. The S$SYSGEN and PATCH 
directories contain the standard DX10 object modules, the data files used by GEN990 for prompt- 
ing and building system generation files, and user-defined and released configuration files. To 
conserve space on your main system disk of a multiple disk system, you can copy the S$SYSGEN 
and PATCH directories to a secondary disk using the Copy Directory (CD) SCI command. 

If this is the first generation of a particular configuration, respond to the prompt INPUT 
CONFIGURATION? by pressing the Return key. If you are regenerating an existing configuration, 
enter that configuration's unique name and press the Return key on your terminal. 

If this is the first generation of a particular configuration, respond to the prompt OUTPUT 
CONFIGURATION? by entering a unique name. This name, identifying the configuration, must 
begin with an alphabetic character and contain no more than five characters. If you are regenerat- 
ing an existing configuration, you can enter that configuration's name and the new configuration 
replaces the old one. You can preserve the existing configuration and create a new one by enter- 
ing a new name. 

When you respond to the above prompts, GEN990 displays the following heading: 
| GEN990-AUTO SYSTEM GENERATION DX10 X.X.X 

GEN990 continues by prompting you for the parameter values in TTY mode (one line at a time). 
GEN990 often displays a parameter's default value enclosed in parentheses (for instance, 60 is 
the default value for LINE?). Table 3-7 lists and describes the XGEN prompts. The paragraphs fol- 
lowing the table give more detailed explanations. 

NOTE 

Designate hexadecimal numbers with a leading zero (0) or a leading 
right-angle bracket (>), as in 0152 and >152. DX10 considers num- 
bers that are not so designated to be decimal numbers, such as 152. 
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Table 3-7. GEN990 Parameters 



Prompt (and Default Value) 



Value Description 



LINE? (60) 

TIME SLICING ENABLED? (YES) 

TIME SLICE VALUE? (1) 

TASK SENTRY ENABLED? (YES) 
TASK SENTRY VALUE? (60) 



TABLE? 
COMMON? 

INTERRUPT DECODER? (NONE) 

RLE MANAGEMENT TASKS? (2) 

CLOCK? (5) 
RESTART ID? (NONE) 

OVERLAYS? (2) 

ONLINE DIAGNOSTIC SUPPORT? NO 

SYSLOG? (6) 

BUFFER MANAGEMENT (BYTES)? (1024) 

I/O BUFFERS? (0) 



Line frequency (50 or 60 Hz) 

Do you want to time slice? 

Number of system time units in one slice 
(one system time unit equals 50 milli- 
seconds). 

Do you want to reduce automatically the 
priority of tasks that execute longer than 
a value defined during system generation 
without giving up the CPU? 

Number of system time units a task is 
allowed to execute without giving up the 
CPU before its priority is reduced (one 
system time unit equals 50 milli- 
seconds). 

Size of the system table area in words. 

File which contains the system common 
image (optional). 

File which contains the object code 
of a user-supplied interrupt decoder 
(optional). 

Number of file managers to include in the 
system. 

Interrupt level of the clock. 

Installed ID of the initial task to be exe- 
cuted (optional). 

The number of system overlay areas (400 
words per overlay area). 

Include optional disk performance diag- 
nostics? 

The number of system log messages 
which may be queued. 

Size in bytes of the largest physical 
record. 

Size in bytes of additional system area to 
be used as device I/O buffers. 
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Table 3-7. GEN990 Parameters (Continued) 



Prompt (and Default Value) 



Value Description 



INTERTASK? (100) 



ITC MESSAGES? (3) 



Size in words of intertask communi- 
cation area appended to system table. 

Maximum number of intertask com- 
munication messages that a task can 
have in the intertask communi- 
cation area. 



KIF?(YES) 



COUNTRY CODE? (US) 



Do you want to include logic to support 
key indexed files (KIFs)? 

In which country is this system being 
used? 



POWER FAIL? (NO) 



AUTO MEDIA CHANGE RECOVERY ? (YES) 



SCI BACKGROUND? (2) 



Do you want to include Model 911 VDT 
power recovery option? 

Do you want to protect disks from acci- 
dental volume changes? 

Maximum number of batch (background) 
SCIs which can be active at one time. 



SCI FOREGROUND? (8) 



Maximum number of interactive (fore- 
ground) SCIs allowed to be active at one 
time. 



BREAKPOINT? (16) 



PANEL DISPLAY (BAR CHART)? (YES) 



Maximum number of breakpoints allowed 
under system. 

Should the front panel data light-emitting 
diodes (LEDs) display disk and CPU activ- 
ity (YES) or the current program counter 
value? 



CARD1? 



CARD 2? 



DEVICE TYPE? 



CRU ADDRESS? 



Interrupt level of expansion chassis 1-4 
(optional). 

Interrupt level of expansion chassis 5-7 
(optional). 

Type of a device to be added to system 
(namely, LP, CRDR, ASR, KSR, DS, VDT, 
MT, DK, SD, COM, RTS). 

CRU address of device being added 
(hexadecimal, multiple of >20, range from 
> 0000 to >1EE0). 
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Table 3-7. GEN990 Parameters (Continued) 



Prompt (and Default Value) 



Value Description 



TILINE ADDRESS? 



ACCESS TYPE? or 
CASSETTE ACCESS TYPE 

TIME OUT? or 
CASSETTE TIME OUT? 

PRINT MODE? (SERIAL) 

EXTENDED? (YES) 



INTERRUPT? 
EXPANSION CHASSIS? 

EXPANSION POSITION? 

CHARACTER QUEUE? (6) 

DRIVES? (1) 

DEFAULT RECORD SIZE? (768) 

VDTTYPE? 
INTERFACE TYPE? 

CHANNEL NUMBER? 
SPEED? 
INTERRUPT CRU BIT? 



TILINE address of device being added 
(hexadecimal, multiple of >20, range 
from > F800 to FCOO). 

Either record- or file-oriented device. 



Time interval allowed to elapse for I/O 
before error. 

Either serial or parallel mode of printing. 

Do you want the extended character set 
for this serial printer (applies only to Tl 
Model 810 printer)? 

Interrupt level assigned to device (3 - 15). 

Number of expansion chassis to which 
device is attached (1 - 7). 

Interrupt level on expansion chassis 
(0-15). 

Number of unrequested input charac- 
ters buffered for device. 

Number of drives on a multidrive device 
(such as a disk or magnetic tape). 

Physical record size, in bytes, given to 
disk files when the default is specified in 
the SVC block. 

Either 911 VDT, 913 VDT, 931 VDT, Busi- 
ness System terminal, or 940 EVT. 

The type of interface the device is using. 
A peripheral is connected to the host 
through an interface board. Refer to 
Table 3-9. 

The channel number on the board to 
which the device is connected. 

The speed at which the device is operat- 
ing. 

The CRU bit (0-30) which indicates an 
interrupt. 
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Table 3-7. GEN990 Parameters (Continued) 



Prompt (and Default Value) 



Value Description 



NAME? 
KSB? 

DSR WORKSPACE? 
INTERRUPT ENTRY? 
PDT FILE? 

DSR FILE? 

OVERRIDE? (Y) 

SVC? 

FILE? 

BYTES? (1) 
NEXT? 



The name of a special device, 1 - 4 char- 
acters. 

Starting label (1-6 characters) of the 
keyboard status block (KSB), if any, for 
special device. 

Label of the device service routine (DSR) 
workspace for the special device. 

Label of the interrupt entry point in the 
DSR. 

Pathname of the file that contains the 
source code for the physical device table 
(PDT) for the device. 

Pathname of the file which contains the 
DSR for the device. 

Do you want GEN990 to override PDT 
fields? (Y or N) 

Starting label of the SVC processor where 
the system is to transfer control. 

Pathname of the file which contains the 
object code for the SVC processor. 

Number of bytes in the SVC block. 

Issue an inquire mode command. 



3.4.1 Defining the GEN990 Operating Prompts 

GEN990 prompts you to define the operating parameters of your customized system. The operat- 
ing parameters tell GEN990 where its input should be and where its output should go. To respond 
to the GEN990 prompts, read the following parameter descriptions. 

3.4.2 Defining the System Timing Parameters 

The following parameters are used to define timing values which are used by the new operating 
system to perform multiprogramming in a real-time environment. All of the parameters have 
default values which can be used by users who are mainly interested in changing DX10 optional 
features or adding new devices. 
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3.4.2.1 LINE Parameter. The LINE parameter specifies the power line frequency to which the 
computer is connected. Line frequencies vary between different countries (for example, 60 Hz in 
the U.S.A. and 50 Hz in Europe). GEN990 will accept either 50 or 60, with 60 being the default value. 
For a Business System 300 or 300A, always specify 50. 

3.4.2.2 TIME SLICING ENABLED Parameter. This parameter enables or disables time slicing. 
In a system with time slicing enabled, each task is allowed to execute for a interval of time defined 
during system generation. After a given task has executed for this time interval, DX10 checks to 
see if another task with the same priority is waiting to execute. If such a task is waiting, the first 
task is suspended, so allowing other tasks to execute. In a system with time slicing disabled, the 
highest priority task will execute until it completes or voluntarily suspends execution. The initial 
value is YES. 

3.4.2.3 TIME SLICE VALUE Parameter. This parameter specifies the length of a time slice in 
system time units. (One system time unit equals 50 milliseconds.) In a system with time slicing 
enabled, each task is allowed to execute for a certain interval of time. After this time interval has 
expired, the task is suspended and other tasks are given a chance to execute. The length of this 
time interval is known as the time slice. The initial value is one system time unit. 

3.4.2.4 TASK SENTRY ENABLED Parameter. This parameter enables or disables the Task Sen- 
try. The Task Sentry, when enabled, keeps track of how long a task executes without voluntarily 
suspending execution (by calling an SVC that requires the task to be rescheduled after the SVC 
completes). When this time exceeds a value defined during system generation, the execution 
priority of the task is reassigned to the next lower priority level. The Task Sentry can be enabled 
concurrently with time slicing. However, if you do not choose to enable time slicing, you should 
enable the Task Sentry to prevent any single task from monopolizing the CPU. The initial value for 
this parameter is YES. 

3.4.2.5 TASK SENTRY VALUE Parameter. This parameter specifies the length of time a task 
may execute without voluntarily giving up the CPU before its execution priority is reduced. The 
value is given in system time units. (One system time unit equals 50 milliseconds.) The default 
value is 60 system time units. 

3.4.3 TABLE Parameter 

The TABLE parameter specifies the size of the system table area. The system table area is part of 
the operating system and is used to contain system log messages, intertask communication 
messages, buffered SVC blocks, and many system-built tables. There is no default value for this 
parameter. The response to the TABLE prompt must be an integer number of words of memory (for 
example, 4000). Table 3-8 is a guideline for estimating system table area. Using the values given in 
the table, estimate the size and complete the system generation. GEN990 will not accept a value 
smaller than 2048 words. 
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You can tune your system generation to have the maximum possible system table area by using 
the following procedure: 

1. Perform a trial ALGS. 

2. Find the length of the task (length of phase 0) from the system link map. Subtract that 
number from >F740. 

3. Find the origin of the module name FILMG in phase 1 from the system link map 
(LINKMAP file). Subtract that number from >C000. 

4. The system table area can be larger by the smaller of these two numbers. If both results 
are negative, the system root is too large and must be made smaller by the larger of the 
absolute values. If one result is negative, the system root must be made smaller by the 
absolute value of the one that is negative. 

5. These calculations are in hexadecimal bytes. The TABLE parameter in system genera- 
tion uses decimal words. You need to convert the hexadecimal number to decimal and 
divide by 2. 

6. Repeat system generation and change the table area by the amount from step 5. 

7. Repeat the ALGS and proceed with the rest of the steps to complete the system 
generation. 

When the system has been used for a while with your application, the size can be fine tuned using 
the Show Memory Status (SMS) command. Enter the SMS command at a terminal with an active 
SCI. Subtract the number given as LARGEST AREA USED from the number given as SYSTEM 
TABLE AREA. The resulting figure is the amount of table area that has never been used since the 
last initial program load. If the amount is large (ten percent of the table size or more), the system 
may be regenerated with a correspondingly smaller TABLE parameter. Do not reduce the table 
area enough to remove all of the unused space. Allow a cushion of at least 500 words. Allow 1000 
words if you choose to include KIFs. 
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Table 3-8. System Table Area Sizing Guideline 



Features Included Size of Table Area in Words 

Base System (includes support for 1 disk drive, 3200 

1 VDT, 1 SCI foreground, 
1 SCI background, 1 file management) 

Each additional foreground* 650 

Each additional background" 800 

Each additional disk drive 40 

Each additional file management task (a system 190 

generation defined number; see paragraph 
3.4.4.3) 

Diskette 128 

Each installed disk volume with an opened KIF 133 

Each serial line printer 70 

Each parallel printer 210 

Note: 

* These figures are based on peak usage. 



3.4.4 Defining Optional Features 

The following prompts allow you to include or exclude many optional features in the new DX10 
system. They all have default values that should be used if you are only interested in adding 
devices to the system. 

3.4.4.1 COMMON Parameter. This parameter is the pathname of the file which contains user- 
supplied object for the system common area of memory. If no file is specified, no system common 
area will be created. System common is memory reserved within the system which is available to 
all tasks via the Get Common Data SVC (> 10), and thus may be used to exchange data between 
tasks. 

The object file (usually produced by the assembler from an assembly source module) can arso 
include code to define application dependent constants in system common. The source must be 
assembled before it can be used by GEN990. 

3.4.4.2 INTERRUPT DECODER Parameter. This parameter is the pathname of the file which 
contains a user-supplied object for an interrupt decoder module. If a file name is entered, GEN990 
includes your interrupt decoder instead of generating the standard interrupt decoders and tables. 
If you enter nothing, GEN990 creates an interrupt decoder which is suitable for most systems. 
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3.4.4.3 FILE MANAGEMENT TASKS Parameter. This parameter is the number of copies of the 
file management task which are to be included in the new system. File management tasks can 
process any file I/O request; therefore, more than one task can process requests at the same time. 
However, each copy of the file management task reduces the maximum possible system table 
area by about 370 bytes. A system will run with only one file management task. Two provides 
significantly better throughput than one even if only one controller is present. At the other 
extreme, one file management task per disk controller provides all necessary file management 
capabilities. More than three file management tasks, however, do not improve throughput signifi- 
cantly, regardless of the number of disk controllers present. The default value is two. 

3.4.4.4 CLOCK Parameter. This parameter is the interrupt level to be assigned to the internal 
clock, and may be either 5 or 15, with 5 being the default value. If 15 is specified, the clock must be 
wired for the level 15 interrupt. This can be done by changing a jumper wire on the system inter- 
face board (see the Model 990/10 or 990/12 Minicomputer Hardware Reference Manual for details). 
Having a level 15 clock interrupt may affect time slicing, but it gives all other devices (particularly 
communication devices and card readers) a higher interrupt priority than the clock, reducing the 
possibility of timing errors on these devices. 

3.4.4.5 RESTART ID Parameter. The number specified is the installed ID of a task which will 
automatically be the first task to execute each time an IPL occurs. Select an ID not reserved for 
DX10 tasks (see Appendix B) since the task must be installed on the system program file. If no 
task ID is specified, no task is automatically bid at IPL. 

3.4.4.6 OVERLAYS Parameter. This parameter specifies the number of system overlay areas to 
be reserved in system memory. The system overlay area is used to contain overlays needed by 
DX10 tasks, such as the file management, bid task, and disk manager. Adding more system overlay 
areas to the system (the maximum is 14) decreases the number of disk accesses needed by the 
system to execute and improves system throughput. However, each additional overlay area 
reduces maximum possible system table area by 806 bytes. A system will function with only one 
system overlay area (a minimum of one is required). More than three overlay areas (five in a system 
that uses KIFs) offer diminishing improvement in throughput. Most systems run satisfactorily with 
two. The initial value is two overlay areas. 

3.4.4.7 ONLINE DIAGNOSTIC SUPPORT Parameter. If selected, the Online Diagnostics func- 
tion during normal system operation, collecting and providing information about the performance 
of disk drives, if selected, the extended disk and magnetic tape DSRs, needed to support the 
online diagnostic tests, are installed; if not selected, the regular DSRs are installed. The Online 
Disk Diagnostic provides online test capability and provides information that permits evaluation 
of the frequency and severity of errors experienced with disk drives. The magnetic tape DSR is 
only installed if tape devices (MTxx) are defined in the system. 

3.4.4.8 SYSLOG Parameter. The number to be specified is the number of messages which may 
be queued for the system log. Any number greater than zero is valid. The initial value is six. If you 
choose too small a number, messages may arrive faster than they can be processed and, as a 
result, some messages may be lost. Although table area is used only while the message is 
queued, choosing too large a number risks table area overflow. This degrades performance and 
may inhibit the execution of some tasks; it may also cause a system crash. 
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3.4.4.9 BUFFER MANAGEMENT Parameter. This parameter specifies the size of the memory- 
resident file buffer in bytes. The memory-resident buffer is used by file management to perform file 
I/O for blocked files only (see Volume I for information on blocked files). It is made memory resi- 
dent in order to allow tasks to use blocked file I/O in small memory configurations where the sys- 
tem may not be able to allocate free memory for a blocking buffer. You can make this buffer very 
small to maximize your task execution space, but this decision risks > DF errors. (Refer to Volume 
VI for a description of error codes.) Establishing a memory-resident buffer does not reduce system 
table area, but decreases the physical memory space available for task execution. 

Note that only one block is stored in this buffer at one time regardless of how much space you 
allocate to the buffer. File management shares the memory-resident buffer between files as 
needed. 

The size of this buffer should be as great as the largest physical record defined for any file to be 
used on the system. There is no point in making it larger. The initial value is 1024 bytes. 

3.4.4.10 I/O BUFFERS Parameter. This parameter specifies the maximum amount of memory, 
in bytes, to be added to the system table area. It is used for buffering device I/O data blocks for 
CRU type devices only. The number need not account for the buffers associated with the physical 
device tables for standard devices (see Section 5 for a discussion of PDTs). It should include the 
total amount of buffer space defined for nonstandard CRU devices. You should also consider the 
expected number of Initiate I/O calls which will be made to the system. Having extra buffer space 
will allow a task to execute several Initiate I/O SVCs, which allows a device to service an I/O 
request. Instead of possibly having to wait for the calling task to be rolled in before the data can 
be unbuffered and then wait for the task to issue the next request, the buffer for the next queued 
I/O request can be used and the I/O request can be served immediately. The initial value is 0. 

3.4.4.11 INTERTASK Parameter. This parameter specifies the maximum size of the intertask 
communications area (in words). This area is statically allocated out of user memory, and is used | 
to contain messages created by the Put Data SVC. This area must be at least as large as the largest 
message your application sends to another program. 

3.4.4.12 ITC MESSAGES Parameter. This parameter specifies the maximum number of inter- 
task communication messages that can be in the intertask communications area for any given 
queue ID. An error is returned if the task attempts to exceed the maximum number. The initial 
value is 3. A greater value is necessary only if an application needs to store messages between 
the time they are sent and received. 

3.4.4.13 KIF Parameter. You have the option of including or excluding the logic for KIFs in the 
system being generated. You must answer YES if you want to use KIFs, including KIFs with 
COBOL. Excluding the KIF logic saves 2.5K words of memory (which does not affect system table 
area), and reduces the maximum system table area load due to KIF I/O by about 210 words per file 
manager task. Legal responses to the KIF prompt are YES (include KIF logic) and NO (exclude KIF 
logic), with YES being the initial value. 
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3.4.4.14 COUNTRY CODE Parameter. This parameter specifies in which country this system is 
being used. The response may be either the full or abbreviated country name. Refer to Volume III 
for more information on international considerations. The initial value is US (United States). 

3.4.4.15 POWERFAIL Parameter. If you include the Model 911 VDT powerfail recovery feature, 
the VDT screens are refreshed and rebuilt after a power failure occurs. You cannot use this feature 
unless the system has battery power support. If you respond YES to the POWERFAIL prompt, 
each 911 VDT in the system requires 2058 additional bytes of physical memory space for storing 
the screen image. The initial value is NO. 

3.4.4.16 AUTO MEDIA CHANGE RECOVERY Parameter. With several types of disk drives, 
unloading a disk or powering down a drive while a volume is still logically installed causes a con- 
dition in which subsequent writes to the disk are prevented. If you accept automatic media 
change recovery, the disk DSR automatically reads the volume information from the disk to deter- 
mine if the volume has been changed. If the volume that is currently loaded is the same as the vol- 
ume that is logically installed, the write protection is turned off. If you do not accept automatic 
media change recovery, write protection remains in effect until you issue an Unload Volume (UV) 
command or a Check and Reset Volume (CRV) command to the drive. If media change occurs on 
the system disk, a crash results. The automatic media change recovery option adds 170 bytes to 
the memory-resident code, which reduces total space available for user programs, but does not 
reduce maximum possible system table area. 

3.4.4.17 SCI BACKGROUND and SCI FOREGROUND Parameters. These two numbers specify 
the maximum number of foreground (interactive) and background (batch) activations of the SCI 
allowed at any one time. If the maximum number of foreground terminals is already logged-on, 
then any additional log-on attempt is cancelled and an error message appears at the terminal. If 
the background limit is exceeded, the request is queued and will be serviced when the number of 
background SCI activations is lower than the limit. By specifying these parameters, you can limit 
access to the operating system being generated, and thereby ease some of the demand for sys- 
tem resources. Any number greater than zero is valid. The recommended practice is to allow one 
foreground area for each terminal on the system and two background areas to be shared by the 
entire system. The initial value is 8 for FOREGROUND and 2 for BACKGROUND. 

Background tasks, receiving the lowest priority, level three, only execute when all higher priority 
tasks are terminated or suspended. DX10 then divides available CPU time equally among level 
three tasks. The following examples demonstrate the consequences of different numbers of back- 
ground areas. 

In a system in which two background areas are specified, two simultaneously bid background 
tasks each require five minutes of execution time. Ten minutes are required for one of the tasks to 
finish. If four such tasks are simultaneously bid, ten minutes pass before two tasks are completed 
and ten more minutes pass before the other two are completed. On a system with 10 foreground 
and 10 background areas, if 10 terminals each simultaneously submit a 5 minute background task, 
50 minutes pass at which time all 10 tasks complete. In the same system with only two back- 
ground areas, only two tasks execute at one time and each one completes in 10 minutes. For this 
reason, the recommended value for BACKGROUND? is 2. 
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It is also true that background tasks requiring long execution times can lock out other background 
tasks. Suppose that 2 background tasks, each requiring 45 minutes, are submitted in a system 
allowing two background tasks. After 5 minutes, a third background task requiring 5 minutes is 
submitted. With 2 background areas available, one of the 45-minute tasks must complete (after 90 
minutes) before the 5-minute task can even begin to execute. With 3 background areas available, 
the 5-minute task should complete within the next 15 minutes, delaying completion of the 45- 
minute tasks by about 5 minutes. 

3.4.4.18 BREAKPOINT Parameter. This number specifies the number of breakpoints allowed 
under the system. Breakpoints are used by the system debugger for interrupting program execu- 
tion (see Volume ill for information on the debugger). The initial value is 16. 

3.4.4.19 PANEL DISPLAY(BAR CHART) Parameter. The value of this parameter determines the 
data displayed on the data LEDs on the computer system's programmer panel. If you respond YES 
(the default value), the display is a bar chart representing the computer's performance. The eight 
leftmost LEDs represent the percent of system disk usage, such that if the four leftmost LEDs are 
lit, then 50 percent of the system disk's access potential is being used. Similarly, the eight right- 
most LEDs represent the percent of available CPU cycles being used. If you respond NO, the cur- 
rent value of the program counter is displayed on the LEDs, and the Show Memory Map (SMM) 
command usage statistics for the system disk and the CPU reflect a value of 0. Note that if you 
respond YES, the chart display uses a small, but measurable, amount of CPU time. 

3.4.4.20 CARD 1 and CARD 2 (Defining Expansion Chassis). GEN990 allows definition of 
expansion chassis by prompting the CARD parameters. These parameters specify the different 
interrupt levels in the main chassis to be assigned to CRU expansion cards 1 and 2. Card 1 sup- 
ports expansion chassis 1, 2, 3, and 4. Card 2 supports expansion chassis 5, 6, and 7. Card 1 and 
card 2 can be implemented either on one full-size CRU expander board or on two separate boards. 
If two boards are used, only ports 5, 6, and 7 can be used on the second board. If port 8 is used, a 
system crash results. If no number is specified, GEN990 assumes that there is no expansion card. 
Refer to paragraph 3.2.3.1 for a discussion of interrupts within an expansion chassis. Refer to 
paragraph 3.2.2.3 for a discussion of CRU base addresses within an expansion chassis. Refer to 
paragraph 3.4.5.1 for a discussion of defining devices that are configured in an expansion chassis. 

3.4.5 Defining Devices 

To define all of the devices included in your system's physical configuration, enter the inquire 
mode by issuing the INQUIRE command. GEN990 displays the following prompt: 

NEXT? 
Respond to NEXT? with the following command: 

DVC 
GEN990 displays the following prompt: 

DEVICE TYPE? 
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Reply to this prompt with the type of a specific device. The types of devices supported by DX10 are 
the following: 

VDT or CRT Model 91 1,913, or 931 VDT; or 940 EVT 

CRDR Model 804 Card Reader 

LP Model 306, 588, 810, 850, 855, 2230, 2260 or 880 Line Printer; 

or 840 RO, LP300, LP600, or LQ45 
ASR Model 733 ASR 

KSR Model 703/707 KSR, 733/743 KSR, 820 KSR, or teleprinter device 

DK Model FD800 Single-Sided, Single-Density Flexible Diskette Drive 

MT Model 979A, MT1600, or MT3200 Magnetic Tape Drive, 

or WD800 Tape Cartridge Drive 
DS DS10, DS25, DS31 , DS32, DS50, DS80, DS200, DS300, WD500, WD500A 

WD800, WD800A, WD900, CD1400/32, CD1400/96, or FD1000 Disk Unit 
COM Communications packages (refer to each object installation 

guide for each communications package) 
SD Special device (that is, nonstandard device) 

RTS Remote Terminal Subsystem Communications Line 

For each device entered, GEN990 displays prompts for the parameters needed to define the 
device. The following paragraphs provide descriptions of these parameters. 

For each device defined, GEN990 creates a four-character device name (a pair of alphabetic char- 
acters followed by a pair of numeric characters). The alphabetic characters indicate the device 
group such as DS for TILINE disk drives, DK for flexible diskette drives, and ST for VDTs, auto- 
matic send/receive (ASR) terminals, and keyboard send/receive (KSR) terminals. The two numeric 
characters are assigned in ascending order from 01 to 99. Each unique pair of alphabetic charac- 
ters added to the system begins with numeric pair 01. For a full discussion of device names, refer 
to Volume I. 

Table 3-9 describes the interface boards and their corresponding system generation names. You 
use these names when responding to the INTERFACE TYPE? prompt for various devices. These 
are not all the interface boards supported by Tl; they are the ones you need to know about to per- 
form the current system generation. Table 3-9 also describes which boards you can use on the 
Business System 300, 600, and 800. 

Table 3-10 describes the relationship between these interface boards and some of the peripherals 
to which they may be connected. The board names used in the table are their system generation 
names. 
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Table 3-9. Description of Various Interface Boards 



Interface Boards 


Descriptions 


System 

Generation 

Name 


Used in: 
BS300 BS600 


BS800 


CI401 (COMM l/F) 


Represents old COMM l/F interface; 
CI401 is a new name. 


CI401 


Yes 


Yes 


TTY/EIA 


Current TTY/EIA interface 


TTY/EIA 


Yes 


Yes 


9902 


TMS9902 port on 990/1 0A and 
Business System 300. 


9902 


Yes Yes 





CI402 



CI421 



CI422 



CI403 



CI404 



Two-channel unbuffered CRU 
controller (two 9902 ports) 

Two-channel unbuffered CRU 
controller (one 9902 port and one 
9903 port) 

Four-channel unbuffered CRU 
controller (four 9902 ports) 

Four-channel buffered TILINE El A 
controller 

Four-channel buffered TILINE 
fiber optics controller 



9902 



9902 
9903 



9902 



CI403 



CI404 



Yes Yes 



Yes 



Yes 



Yes 



Yes 



Yes Yes 



Table 3-10. Relationship Between Peripherals and Interface Boards 



Peripherals 



931 VDT 
940 EVT 
LP (Serial) 
TPD 
Special Device 



Attachable Interface Boards 
CI401 
(COMM l/F) TTY/EIA 9902 9903 CI403 CI404 



X 
X 

X 
X 
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3.4.5.1 Defining Devices in an Expansion Chassis. TILINE devices in expansion chassis are 
physically linked to the main chassis by a pair of interconnected TILINE coupler boards, one in the 
main chassis and one in the expansion chassis. These TILINE couplers are not apparent to the 
software. 

However, TILINE devices typically share an expansion chassis with CRU devices. CRU devices are 
physically linked to the main chassis by a pair of interconnected boards: a CRU expander board in 
the main chassis and a CRU buffer board in the expansion chassis. The CRU expander and the 
CRU buffer are apparent to the software. In fact, the INTERRUPT parameter for a CRU or TILINE 
device in an expansion chassis is the interrupt level assigned to the CRU expander in the main 
chassis. 

Definition of devices in expansion chassis requires that you specify the two additional 
parameters: 

• Expansion chassis 

• Expansion position 

When defining a device in an expansion chassis, GEN990 prompts you for EXPANSION CHASSIS. 
This parameter specifies the expansion chassis (1 through 7) to which the device is connected. 

GEN990 then prompts the EXPANSION POSITION parameter. This parameter specifies the inter- 
rupt level (0 through 15) assigned to the slot on the expansion chassis to which the device is con- 
nected. Refer to paragraph 3.2.3.1 for more information on interrupts in expansion chassis. 

TILINE Devices In Expansion Chassis. When you define a TILINE device in an expansion chas- 
sis, GEN990 recognizes the interrupt as the same one specified in the CARD 1 or CARD 2 parame- 
ter and knows to prompt for additional parameters. 

The following example demonstrates the definition of a disk drive whose controller is installed in 
slot 7 of the second expansion chassis of a system. The second expansion chassis is also con- 
nected to Card 1 of a CRU expander in slot 11 of the main chassis. 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F820) 

DRIVES? (1)1 

DEFAULT RECORD SIZE? (864) 

INTERRUPT? (13) 7 

EXPANSION CHASSIS? 2 

EXPANSION POSITION? 13 
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Your responses to the prompts are the same as if the controller board were installed in the main 
chassis with the following exceptions: 

• The correct INTERRUPT parameter is the interrupt level assigned to the CRU expander 
board in the main chassis. 

• The EXPANSION CHASSIS parameter is 2 in this example, to indicate that the disk con- 
troller board is installed in expansion chassis 2. 

• The EXPANSION POSITION parameter in this example is 13, which is the interrupt level 
of the disk controller board within the expansion chassis. 

CRU Devices in an Expansion Chassis. When you define a CRU device in an expansion chassis, 
be sure to assign the correct CRU base address. Refer to paragraph 3.2.2.3 for a discussion of 
CRU base addresses in expansion chassis. GEN990 recognizes this CRU base address to be 
within an expansion chassis and prompts you for the same additional prompts described in the 
preceding paragraph. The following example demonstrates the definition of a 911 VDT controlled 
by the right half of a controller board which is installed in slot 9 of expansion chassis 1. The CRU 
expander board is installed in slot 11 of the main chassis: 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 500 
INTERRUPT? (10) 7 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 10 

Your responses to the prompts are the same as if the controller board were installed in the main 
chassis with the following exceptions: 

• The CRU ADDRESS parameter is modified to reflect in which expansion chassis the 
controller board is installed. 

• The correct INTERRUPT parameter is the interrupt assigned to the CRU Expander board 
in the main chassis. 

• The EXPANSION CHASSIS parameter is 1 in this example, to indicate that the 911 VDT 
controller board is installed in expansion chassis 1. 

• The EXPANSION POSITION parameter in this example is 10, the interrupt level of the 
91 1 VDT controller board within the expansion chassis. 
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3.4.5.2 Defining Disk and Magnetic Tape Drives. Supply the following GEN990 parameters to 
add a disk drive to a new DX10: 

DEVICE TYPE 

TILINE ADDRESS 

DRIVES 

DEFAULT RECORD SIZE 

INTERRUPT 

The parameters required to add a tape transport are the same, except the DEFAULT RECORD SIZE 
is neither required nor prompted. 

Respond to the DEVICE TYPE prompt with DS to define a disk and MT to define a magnetic tape 
drive. 

The TILINE ADDRESS parameter is prompted by GEN990 when a TILINE device (in this case, a 
disk drive or magnetic tape unit) has been defined in the system. Respond to this parameter with 
the TILINE ADDRESS of the device just named. See paragraph 3.2.4 for a discussion of the TILINE. 

The DRIVE parameter only applies to disk, diskette, and magnetic tape units, which may have 
more than one drive per controller. Enter the number of drives connected to the controller being 
defined, either 1,2, 3, or 4. The initial value is 1. 

GEN990 requests a DEFAULT RECORD SIZE parameter for each disk controller defined. DX10 
uses the specified number of bytes to define the physical record size of a disk file when none is 
specified in the SVC block or in the directory under which the file is created at file creation 
time. The DX10 routine for volume initialization uses a multiple of three sectors for its unit of disk 
allocation. 

The INTERRUPT parameter specifies the interrupt level (3 through 15) to be assigned to the device 
being described. The interrupt for each slot of your chassis is listed on the configuration label that 
is attached to the chassis. 

The following examples show how to define disks in a new system: 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) 

DRIVES: (1)3 

DEFAULT RECORD SIZE: (768) 

INTERRUPT: (13) 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) > F820 

DRIVES: (1)2 

DEFAULT RECORD SIZE: (768) 

INTERRUPT: (13) 12 
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The following example shows the definition of a tape transport: 

DEVICE TYPE? MT 
TILINE ADDRESS? (F880) 
DRIVES: (1) 
INTERRUPT: (9) 

3.4.5.3 Defining Communications Devices. DX10 optionally supports several types of commu- 
nications packages. The parameters necessary to define communications devices are: 

DEVICE TYPE 

CRU OR TILINE ADDRESS 

NUMBER OF CHANNELS 

PROTOCOL 

• BUFFER SIZE 

• INTERRUPT 



NOTE 

Before you execute GEN990, you should read the object installation 
documents for each communications package that you want to 
install on your system. 

The DEVICE TYPE parameter must be specified as COM or COMM. The CRU or TILINE parameter 
is the address of the slot in the main or expansion chassis in which the communication card is 
connected. If the CRU address is entered as a TILINE address, more than one communications 
device can share that address. If the CRU address is a non-TILINE address, that CRU address can 
be assigned to only one communications device. Calculation of a CRU address is explained in 
paragraph 3.2.2. 

The NUMBER OF CHANNELS parameter should be entered as 1 for a device using a Communica- 
tion Interface board and can be 1 to 4 for a multiple channel device. GEN990 does not verify that 
the value entered is legal since other devices with unknown characteristics can be added in the 
future. 

The PROTOCOL prompt is displayed as many times as the value you entered for the NUMBER OF 
CHANNELS parameter. Valid responses to this prompt are 3780, 2780, or 3270. The 3780 and 2780 
packages are normally used in a hardware configuration, which includes a console device and at 
least one other I/O device (for example, a line printer). The 3270 package is generally used in con- 
junction with VDTs and/or a line printer. The default is NONE. If the default is taken for ail 
NUMBER OF CHANNELS prompts, GEN990 ignores the current COMM device definition. 
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If the response to the PROTOCOL prompt is 3780 or 2780, the BUFFER SIZE prompt is displayed. 
No BUFFER SIZE prompt is displayed if the PROTOCOL response is 3270. The BUFFER SIZE pa- 
rameter specifies the size of the internal CRU buffer to be used by the communications device. 
This buffer is used to receive data from the communications interface card. The default for the 
3780 and 2780 required buffer size is 528 bytes. 

The INTERRUPT parameter specifies the hardware interrupt assigned to the slot in which the 
communications interface card is connected. This parameter is described in paragraph 3.2.3. 

The following examples show how both a 3780 and a 3270 package are defined: 

DEVICE TYPE? COMM 

CRU OR T1LINE ADDRESS? (> 140) 

NUMBER OF CHANNELS (1)? 

CHANNEL NUMBER 00 PROTOCOL? (NONE) 3780 

INTERRUPT? (8) 

BUFFER SIZE (528)? 

DEVICE TYPE? COMM 

CRU OR TILINE ADDRESS? (> 140) > 160 

NUMBER OF CHANNELS (1)? 

CHANNEL NUMBER 00 PROTOCOL? (NONE) 3270 

INTERRUPT? (8) 

3.4.5.4 Defining Display Terminals. The parameters needed to define a 91 1 , 91 3, or 931 VDT, or 
940 EVT are the following: 

DEVICE TYPE 

ACCESS TYPE 

TIMEOUT 

CHARACTER QUEUE 

VDT TYPE 

CRU ADDRESS 

INTERRUPT 

In response to the DEVICE TYPE prompt, enter VDT or CRT. 

The ACCESS TYPE should be specified as either RECORD or FILE. A device that is record oriented 
can be opened for I/O by many tasks concurrently. A file-oriented device can only be used by one 
task at a time. The initial value for VDTs is RECORD. Refer to Volume I for a discussion of file 
orientation. 
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The TIME OUT parameter specifies the number of seconds DX10 allows for an I/O operation to 
occur before declaring an error condition. Interactive devices are generally assigned no time-out 
value because the time required for an input operation is operator dependent. The initial value is 
(no time-out). 

The CHARACTER QUEUE parameter specifies the number of input characters to be buffered. The 
initial value is 6. The character queue must be an even number of characters. 

The VDT TYPE parameter allows you to specify whether the device is a 911 , 913, or 931 VDT, or 940 
EVT. Enter either 91 1 , 91 3, 931 , or 940 in response to this prompt. 

The CRU parameter specifies the CRU address of the chassis slot in which the VDT controller is 
connected, as described in paragraph 3.2.2. The initial value is > 100. 

The INTERRUPT parameter specifies the interrupt level assigned to the chassis slot in which the 
VDT controller board is located. The initial value is 10. 

Additional parameters needed to define a 931 VDT or 940 EVT are as follows: 

ASSOCIATED PRINTER 

TIMEOUT 

SWITCHED LINE 

SPEED 

INTERFACE TYPE 

TILINE ADDRESS 

CHANNEL NUMBER 

In response to the ASSOCIATED PRINTER prompt, enter YES if a printer is attached to the auxil- 
iary port on the 931 or 940. An attached printer always has a value of YES in response to the 
EXTENDED? prompt (refer to paragraph 3.4.5.7). The initial value is NO. 

The TIME OUT parameter specifies the number of seconds allowed by DX10 for an I/O operation to 
the printer. If more than the specified amount of time elapses, an I/O error is assumed. A response 
of zero signifies no time-out count (that is, the printer has as long as necessary to complete the 
operation). The initial value is 60 seconds. 



946250-9705 



Change 1 3-43 



System Generation 



The SWITCHED LINE prompt is used to specify the connection procedure for the terminal. 
Respond NO for such configurations as local direct connect cable, leased telephone line with 
modems, and switched telephone line with modems. A NO response to the SWITCHED LINE 
prompt causes the operating system to assert Data Terminal Ready (DTR) and Request to Send 
(RTS) signals unconditionally during IPL. This allows initiation of connection from either the ter- 
minal or the CPU. The response to this prompt is usually NO. A YES response to the SWITCHED 
LINE prompt causes the operating system to await a Ring Indicator (Rl) signal from the modem to 
the CPU before asserting DTR and RTS signals to complete the connection process. Respond YES 
only if all the following conditions are met: 

• The terminal and CPU are connected via a switched telephone line and modems. 

• The modems require a Rl signal prior to asserting DTR and RTS signals. 

• The call is placed from the terminal to the CPU. 

The Modify VDT or Printer Characteristics (MVPC) command can be used to modify a response to 
the SWITCHED LINE prompt without performing another system generation. The initial value is 
NO. 

The SPEED prompt requests the baud rate at which the terminal is operating. Legal baud rates are 
300, 600, 1200, 2400, 4800, 9600, and 19200 baud. Make sure your hardware matches one of the 
listed baud rates. The initial value is 1200. 

The INTERFACE TYPE prompt specifies which interface board the terminal is using. The valid 
responses are CI401 (previously COMM l/F), CI403, CI404, 9902, and 9903. Refer to Table 3-9 for 
more details. 

The TILINE prompt appears if the response to the INTERFACE TYPE prompt is either CI403 or 
CI404. Otherwise, the CRU ADDRESS prompt appears. The TILINE prompt specifies the TILINE 
address of the board to which the VDT is connected, as described in paragraph 3.2.4. The initial 
value is > F980. 
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The CHANNEL NUMBER prompt appears if the response to the INTERFACE TYPE prompt is either 
CI403 or CI404. This prompt specifies the channel number on the board to which the VDT is con- 
nected. The initial value is 0. 

The following example shows the definition of all four VDT types: 

DEVICE TYPE? CRT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) 
INTERRUPT? (10) 

DEVICE TYPE? CRT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 91 3 
CRU ADDRESS? (> 100) > 00 
INTERRUPT? (10) 6 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 940 
ASSOCIATED PRINTER? (NO) 
SWITCHED LINE? (NO) 
SPEED? (1200) 9600 
INTERFACE TYPE? CI403 
Tl LINE ADDRESS? (>F980) 
CHANNEL NUMBER? (0) 
INTERRUPT? (10) 7 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 931 

ASSOCIATED PRINTER? (NO) 
SWITCHED LINE? (NO) 
SPEED? (1200) 9600 
INTERFACE TYPE? 9902 
CRU ADDRESS? (> 1700) 
INTERRUPT? (10) 8 



I 
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3.4.5.5 Defining ASRs. To define a 733 ASR, you must supply the following parameters: 

DEVICE TYPE 

CRU ADDRESS 

ACCESS TYPE 

TIMEOUT 

CHARACTER QUEUE 

CASSETTE ACCESS TYPE 

CASSETTE TIME OUT 

INTERRUPT 

To define an ASR, respond to the DEVICE TYPE prompt by entering ASR. 

The ACCESS TYPE or CASSETTE ACCESS TYPE parameter specifies whether a device is record 
oriented or file oriented. Enter either RECORD or FILE. Record-oriented devices may be accessed 
by many tasks at the same time, but file-oriented devices may only be opened by one task at a 
time. Disks, magnetic tape, and diskettes are automatically record oriented. The default value is 
the standard access type for the device being described. Card readers, line printers, and cassettes 
are usually file oriented, while ASRs, KSRs, and VDTs are typically record oriented. Refer to Vol- 
ume I for a discussion of device orientation. 

The TIME OUT or CASSETTE TIME OUT parameter specifies the number of seconds which is to be 
used by DX10 as the time-out count for the device. When an I/O operation is initiated on a device, 
DX10 allows the device to wait for the time period specified here for the operation to complete, 
after which it assumes that an error has occurred. If no time-out is desired, enter 0. The default 
value is different for different devices: 30 seconds for the line printers and card readers, 3 seconds 
for cassettes, and no time-out for interactive devices. 

The CHARACTER QUEUE parameter specifies the number of characters from a keyboard device 
that should be buffered for input. If more characters are entered in the queue, they are ignored. 
The initial value is 6. 

The INTERRUPT parameter specifies the interrupt level (3 through 15) to be assigned to the device 
being defined, as described in paragraph 3.2.3. The initial value is 6. 



946250-9705 



3-45 



System Generation 



The following example shows how to define an ASR. GEN990 assigns device names (such as 
ST01, ST02) to terminal devices in the order in which the devices are defined. 

DEVICE TYPE? ASR 
CRU ADDRESS? (> 00) 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
CASSETTE ACCESS TYPE? (FILE) 
CASSETTE TIME OUT? (3) 
INTERRUPT? (6) 

When an ASR is defined, the cassette units are named left to right; in the previous example, CS01 
is the left cassette drive and CS02 is the right drive. If you define more ASRs, GEN990 continues to 
number the cassettes sequentially. 

3.4.5.6 Defining KSRs (or Other Teleprinter Devices (TPDs)). The types of KSRs supported by 
DX10 are 703, 707, 733, 743, 745, 763, 765, 781, 783, 785, 787, and 820. 

NOTE 

You can define a 743 or 745 terminal that is interfaced to a 990 using 
the TTY/EIA interface module and unswitched lines as a KSR using 
either the KSR or the TPD DSR. You can define an 820 terminal that 
is interfaced to a 990 using a TTY/EIA interface module and 
unswitched lines as a KSR using either the K820 or TPD DSR. You 
can define a 733 terminal as either an ASR or a KSR using the KSR 
DSR. It is recommended that 743, 745, or 820 terminals be defined 
using the TPD DSR. This allows you to access various utility pro- 
grams not otherwise available. Future utility software developed to 
operate with hard-copy terminals may not operate for terminals that 
are not defined as TPD devices. 



The parameters needed to define a KSR device are the following: 
DEVICE TYPE 
DSR TYPE(TPD/KSR/K820) 
CRU ADDRESS 
ACCESS TYPE 
TIMEOUT 

CHARACTER QUEUE 
INTERRUPT 
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In response to the DEVICE TYPE prompt, enter KSR. 

In response to the DSR TYPE(TPD/KSR/K820) prompt, enter either TPD, KSR, or K820, according to 
the nature of the device you are defining. 

The CRU ADDRESS parameter specifies the CRU address of the chassis slot in which the inter- 
face is connected, as described in paragraph 3.2.2. The initial value is > 00. 

The ACCESS TYPE should be specified as either RECORD or FILE. A device that is record oriented 
can be opened for I/O by many tasks concurrently. A file-oriented device can only be used by one 
task at a time. The initial value for TPD is RECORD. Refer to Volume I for a discussion of file orien- 
tation. 

The TIME OUT parameter specifies the number of seconds that DX10 allows for an I/O operation to 
occur before declaring an error condition. Interactive devices are generally assigned no time-out 
value, since the time required for an input operation is operator dependent. The initial value is 
(no time-out). 

The CHARACTER QUEUE parameter specifies the number of input characters to be buffered. If 
the Bubble Memory Terminal Support software (BMTS-990) is used at this port, see the BMTS-990 
User's Guide for additional information regarding this parameter. The initial value is 6. 

The INTERRUPT parameter specifies the interrupt level assigned to the chassis slot in which the 
VDT controller board is connected, as described in paragraph 3.2.3. The initial value is 6. 

Additional parameters needed to define a TPD are the following: 

TERMINALTYPE 

INTERFACE TYPE 

SWITCHED LINE 

BAUD RATE 

ACU PRESENT 

ACUCRU* 

FULL DUPLEX MODEM " 

ECHO 



* Not always prompted. 
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The TERMINAL parameter allows you to specify which type of terminal you are defining. The 
allowed responses are 703, 707, 743, 745, 763, 765, 781, 783, 785, 787, and 820. 

The ECHO prompt asks whether keystrokes should be echoed (sent back to the terminal) by the 
990. The default is YES. Echo must be selected for character editing to work properly at the ter- 
minal. If echo is selected, the terminal must be configured without local copy. If a half-duplex 
modem is used, echo should not be selected. 

FULL DUPLEX MODEM asks if the modem is full duplex or half duplex. If the modem is a Bell 103J 
or a Bell 21 2A or a Vadic 3400, answer YES. If no modem is used, enter YES. If the modem is a Bell 
202S, enter NO. 

Respond to the SWITCHED LINE prompt to specify the type of telecommunication used with the 
TPD. Remote terminals accessed using modems on the public telephone network are on switched 
(dial-up) lines. Directly connected terminals and terminals on leased remote lines are not 
switched. For the latter case, accept the initial value of NO. If the terminal uses dial-up lines, 
respond Y (YES). 

The INTERFACE TYPE prompt specifies which interface board the terminal is using. The valid 
responses are CI401 (previously COMM l/F), TTY/EIA, and 9902. Refer to Table 3-9 for more details. 

Acceptable BAUD RATES are 110, 300, 600, 1200, 2400, 4800, and 9600. The initial value is 300 
baud. Make sure your hardware matches one of the listed baud rates. 

If an automatic call unit is used with the terminal, enter YES in response to the ACU PRESENT? 
prompt; otherwise, accept the initial value of NO. If you respond YES, GEN990 displays another 
prompt, ACU CRU?. Respond with the CRU base address of the ACU. The initial value is 0. 

The following example shows the definition of three devices: 

DEVICE TYPE? KSR 
DSRTYPE(TPD/KSR/K820)? KSR 
CRU ADDRESS? (> 00) 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
INTERRUPT? (6) 

DEVICE TYPE? KSR 

DSR TYPE(TPD/KSR/K820)? K820 

CRU ADDRESS? (> 00) > 40 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

INTERRUPT? (6) 
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DEVICE TYPE? KSR 

DSR TYPE(TPD/KSR/K820)? TPD 

TERMINAL TYPE? (743) 

INTERFACE TYPE? CI401 

SWITCHED LINE? (NO) 

BAUD RATE? (300) 1200 

ACU PRESENT? (NO) 

FULL DUPLEX MODEM? (YES) 

ECHO (YES)? 

CRU ADDRESS? (> 00) > 60 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

INTERRUPT? (6) 

3.4.5.7 Defining Line Printers. The types of line printers supported by DX10 are: Model 306, 588, 
810, 820 RO, 840 RO, 850, 855, 2230, 2260, LP300, LP600, and LQ45. The prompts needed to define a 
line printer are the following: 

DEVICE TYPE 

ACCESS TYPE 

PRINT MODE 

EXTENDED 

SPEED* 

TIMEOUT 

INTERFACE TYPE 

CRU ADDRESS or TILINE ADDRESS 

CHANNEL NUMBER 

INTERRUPT 



* Not always prompted. 
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The DEVICE TYPE prompt requires you to enter LP to define a printer. 

Specify the ACCESS TYPE as either RECORD (R) or FILE (F) oriented. Refer to Volume I for a dis- 
cussion of file orientation. The initial value is FILE. 

The PRINT MODE should be specified as either PARALLEL or SERIAL 

If a printer is specified as being serial, GEN990 prompts the EXTENDED? parameter. The 810 
serial printer may have an extended character set. If the device being added has an extended char- 
acter set, you should answer YES; if not, respond with NO. If you want to print lowercase charac- 
ters, answer YES. The initial value is YES. 

GEN990 also prompts the SPEED parameter if a printer is specified as being serial. The SPEED 
prompt requests the baud rate at which the printer operates. Legal baud rates are 110, 200, 300, 
600, 1200, 2400, 4800, and 9600. Make sure your hardware matches one of the listed baud rates. The 
initial value is 4800. 

The TIME OUT parameter specifies the number of seconds allowed by DX10 for an I/O operation to 
the printer. If more than the specified amount of time elapses, an I/O error is assumed. A response 
of zero signifies no time-out count (that is, the printer has as long as necessary to complete the 
operation). The initial value is 60 seconds. 

The INTERFACE TYPE prompt appears if the response to the PRINT MODE prompt is SERIAL. This 
parameter specifies which interface board the printer is using. The valid responses are CI403, 
CI404, TTY/EIA, and 9902. Refer to Table 3-9 for more details. 

The CRU parameter specifies the CRU address of the chassis slot in which the printer interface 
card is connected, as described in paragraph 3.2.2. The initial value is > 60. 

The TILINE prompt appears if the response to the INTERFACE TYPE prompt is either CI403 or 
CI404. Otherwise, the CRU prompt appears. The TILINE parameter specifies the TILINE address of 
the interface board to which the printer is connected, as described in paragraph 3.2.4. The initial 
value is >F980. 

The CHANNEL NUMBER prompt appears if the response to the INTERFACE TYPE prompt is either 
CI403 or CI404. This parameter specifies the channel number on the interface board to which the 
printer is connected. The initial value is 0. 

The INTERRUPT parameter specifies the interrupt assigned to the chassis slot in which the printer 
interface card is connected, as described in paragraph 3.2.3. The initial value is 14. 
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The following example shows the definitions of three printers: 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
INTERFACE TYPE? TTY/EIA 
CRU ADDRESS? (> 60) 
INTERRUPT? (14) 10 
EXPANSION CHASSIS? (1) 
EXPANSION POSITION? 5 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) P 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
CRU ADDRESS? (> 60) > 100 
INTERRUPT? (14) 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
INTERFACE TYPE? CI403 
TILINE ADDRESS? (> F980) 
CHANNEL NUMBER? (0) 
INTERRUPT? (14) 

3.4.5.8 Defining a Card Reader. The parameters needed to define a card reader are the 
following: 

DEVICE TYPE 

CRU ADDRESS 

ACCESS TYPE 

TIMEOUT 

INTERRUPT 

Enter CR in response to the DEVICE prompt. The CRU parameter specifies the CRU address 
assigned to the card reader. CRU address calculation is described further in paragraph 3.2.2. The 
initial value is>40. 
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NOTE 

Connecting a card reader to an expansion chassis is not recom- 
mended. A card reader generates many interrupts that must be ser- 
viced immediately by DX10; therefore, connect the card reader to 
the main chassis and assign it the lowest interrupt level possible. 
No other device can be assigned the same interrupt level as a card 
reader. 

The ACCESS TYPE parameter indicates whether the card reader is RECORD (R) or FILE (F) ori- 
ented. Refer to Volume I for a discussion of file orientation. The initial value is FILE. 

The TIME OUT parameter specifies the number of seconds in the time-out count for the card 
reader. The initial value is 30. 

The INTERRUPT parameter specifies the interrupt level assigned to the chassis slot in which the 
card reader interface card is connected. This number should be as low as possible. The initial 
value is 4. 

The following example shows definition of a card reader: 

DEVICE TYPE? CR 
CRU ADDRESS? (> 40) > 80 
ACCESS TYPE? (RLE) 
TIME OUT? (30) 
INTERRUPT? (4) 

3.4.5.9 Defining Diskettes. The parameters required to define Model FD800 single-sided, 
single-density diskette drives to GEN990 are the following: 

DEVICE TYPE 

CRU ADDRESS 

DRIVES 

TIMEOUT 

INTERRUPT 

Respond to the DEVICE TYPE prompt by entering DK. 

The CRU ADDRESS parameter specifies the CRU address of the chassis slot in which the diskette 
controller is connected. The default value is > 80. 

The DRIVES parameter specifies the number of diskette drives (1 , 2, 3, or 4) which are connected to 
the controller being defined. GEN990 names each drive DKXX, where XX is the drive number, in the 
same way as disk drives. 
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The TIME OUT parameter specifies the number of seconds allowed by DX10 for an I/O operation to 
a diskette drive to complete. The initial value is 30. 

The INTERRUPT parameter specifies the hardware interrupt level assigned to the chassis slot in 
which the diskette controller is connected. Paragraph 3.2.3 provides a more detailed explanation. 

The following example shows the definition of two diskette drives: 

DEVICE TYPE? DK 
CRU ADDRESS? (> 80) 
DRIVES? (1)3 
TIME OUT? (30) 
INTERRUPT? (7) 

DEVICE TYPE? DK 

CRU ADDRESS? (> 80) > 220 

DRIVES? (1)2 

TIME OUT? (30) 

INTERRUPT? (7) 

3.4.5.10 Defining Nonstandard Devices. The following parameters are required to define a 
device not supported by the standard DX10 software modules: 

• DEVICE TYPE 
INTERFACE TYPE 
SPECIAL DEVICE ADDRESS 

• CHANNEL NUMBER 
DEVICE NAME 

• INTERRUPT BIT 
KSB ADDRESS 
DSR WORKSPACE 

• INTERRUPT ENTRY 
PDTFILE 

• DSR FILE 
OVERRIDE 

• INTERRUPT 

In order to include a nonstandard device, you will have to write a DSR to handle it. See Section 5 
for instructions. You should write the DSR before beginning system generation. 
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Respond to the prompt DEVICE TYPE with SD (Special Device). 

The INTERFACE TYPE parameter specifies which interface board the device is using. The valid 
responses are CI403, CI404, 9902, and NONE. Refer to Table 3-9 for more details. Enter NONE if 
you are not using a CI403, CI404, or 9902. The initial value is NONE. This information is used 
to construct the interrupt decoder tables and does not provide any routines for handling the 
interface. 

In response to the SPECIAL DEVICE ADDRESS parameter, enter the TILINE or CRU address 
assigned to the device. If you respond NONE, the INTERRUPT parameter is also set to NONE and 
the OVERRIDE parameter is set to NO. The initial value for this parameter is > 100. 

The CHANNEL NUMBER prompt appears if the response to the INTERFACE TYPE prompt is CI403 
or CI404. This prompt specifies the channel number on the board to which the device is 
connected. 

Assign a name to the device in response to the prompt DEVICE NAME. The name must be four 
characters long and begin with an alphabetic character. For example, if the device is a plotter, 
then you can assign the name PL01. If a device is a special graphics terminal, you can assign the 
name GR01. For each subsequent definition of this type of terminal, you can use the names GR02, 
GR03, and so on. 

The INTERRUPT BIT prompt appears if the response to the INTERFACE TYPE prompt is NONE. 
When several devices share the same interrupt level, GEN990 must know the CRU interrupt bit 
that indicates which device sent the interrupt in order to build a suitable interrupt decoder. 
Respond to this prompt with the appropriate CRU interrupt bit. The default is 15. The valid values 
are in the range to 31. 

The KSB ADDRESS parameter identifies the label of the starting address of the keyboard status 
block (KSB) for this device as specified in bytes 12 and 13 of the physical device table (PDT). If the 
device does not have a keyboard or if you do not intend to bid SCI with the device, then accept the 
initial value of NONE by pressing the Return key. The device must have a KSB to have an STxx 
(station) device name. 

Respond to the DSR WORKSPACE prompt with the label of the address of the workspace to be 
used by the DSR when processing device interrupts. The conventional value for this parameter is 
either the first word of the KSB (if the device has a KSB) or the third word of the PDT (for nonkey- 
board devices). 

For the INTERRUPT ENTRY parameter, enter the label of the entry point in the DSR for processing 
interrupts for the device. 

Respond to the PDT FILE prompt with the pathname of the file containing the PDT source module. 

Respond to the DSR FILE prompt with the pathname of the file containing the DSR object module. 
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When you write the PDT for the special device, you may not know in which chassis slot the device 
will reside. The data in certain fields in the PDT and KSB (CHASSIS/TILINE ADDRESS and STATUS 
FLG/INTERRUPT-1 in the PDT and CRU INPUT ADDRESS in the KSB) is dependent on the slot 
number. Respond YES to the OVERRIDE parameter if you want GEN990 to fill in these fields 
according to information supplied during system generation. Respond NO if the PDT already con- 
tains this data. If the special device has a keyboard, GEN990 overrides the station ID field in the 
KSB. 

Enter the interrupt level of the slot in which the special device is installed to respond to the prompt 
INTERRUPT. If your response is NONE, the SPECIAL DEVICE ADDRESS PARAMETER is also set 
to NONE and the OVERRIDE parameter is set to NO. The initial value is 15. 

Several examples of special device definition are included in Appendix F. 

3.4.6 Defining SVCs 

You can write your own SVC processors and include them in the DX10 software. It is necessary 
to write the SVC processor and install it in a file prior to defining its parameters during system 
generation. 

GEN990 assigns identifying numbers to user-written SVCs, starting at >80. These numbers are 
assigned in the sequence that the SVCs are defined. These numbers are not displayed in the out- 
put of the LIST command, but they are recorded in the configuration file, which may be inspected. 
If you delete an SVC, the identifying numbers are reordered to maintain an unbroken sequence. If 
you modify an SVC using the CHANGE command, the SVC retains its order in the number 
sequence, even if the content of the SVC has changed. 

To define an SVC, issue the SVC command from the inquire mode. The following prompts appear: 

SVC 

FILE 

BYTES 

The SVC parameter is the label of the initial entry point to a user-supplied SVC processor. You 
must define this label in the processor. User-defined SVCs are assigned SVC codes by GEN990, 
starting at > 80 and incrementing by one for each SVC defined. 

The FILE parameter is the pathname of the file which contains the object module of the SVC pro- 
cessor being defined. 

The BYTES parameter specifies the number of bytes which are used by the call block of the SVC 
just defined. The number must be at least one, which is the initial value. 

After you respond to these prompts, GEN990 returns to the inquire mode. 

3.4.7 Terminating GEN990 

Terminate GEN990 by issuing either the STOP command or the BUILD command. Refer to para- 
graph 3.3.3.7 for a description of these commands' actions. 
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3.4.8 Optional Processor System Generation Parameters 

During system generation, the parameters you specify in response to the GEN990 prompts should 
take into account the optional processors you want to include. The optional processors that can 
have an effect on the system generation procedure include, but are not limited to, the following: 

• 915 RTS 

• Sort/Merge * 
3780/2780 

3270/ICS 

• Bubble Memory Terminal Support (BMTS-990) 

The following paragraphs explain the system generation considerations if you want to include 
these processors. 

3.4.8.1 DX10 Remote Terminal Subsystem (RTS). If you want to include RTS in a DX10 system, 
you must first perform the RTS pre-system generation procedures as specified in the Model 990 
Computer DX10 Remote Terminal Subsystem (RTS) System Generation and Programmer's Refer- 
ence Manual. After you complete these procedures, you can perform the standard DX10 system 
generation procedure with each RTS communications line included as a special device (in addi- 
tion to all other devices that must be included in your system). 

Refer to the Model 990 Computer DX10 Remote Terminal Subsystem (RTS) System Generation and 
Programmer's Reference Manual for information concerning responses to the DX10 system gener- 
ation prompts to include RTS communications. 

3.4.8.2 Sort/Merge. When using Sort/Merge with COBOL, FORTRAN, BASIC, or assembly lan- 
guage, you must specify an intertask communication area. In response to the INTERTASK prompt, 
specify the number of words of the system table area that may be used for intertask 
communications. 

Refer to the system generation requirements section of the Sort/Merge User's Guide for informa- 
tion on how to compute the value required for the intertask communication area. 

3.4.8.3 3780/2780 and 3270/ICS Emulators. The parameters necessary to define these proces- 
sors during the system generation procedure are described in paragraph 3.4.5.3 on defining com- 
munications devices. 

For additional information concerning the system generation procedures for these processors, 
refer to the DX10 3780/2780 Emulator Object Installation and the Model 990 Computer DX10 3270 
Interactive Communication Software (ICS) Object Installation manuals. 

3.4.8.4 Bubble Memory Terminal Support. To use the BMTS-990, you must include a KSR using 
the teleprinter DSR during system generation. The parameters necessary to define teleprinter 
devices during system generation are listed in paragraph 3.4.5.6. For further information on 
BMTS-990, see the Bubble Memory Terminal Support 990 User's Guide. 
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3.5 ASSEMBLING AND LINKING THE SYSTEM 

After you define the system configuration using GEN990, the data files must be processed into a 
machine-useable form. DX10 provides the Assemble and Link Generated System (ALGS) com- 
mand to perform this processing automatically. 

NOTE 

If you are generating any communications products, make sure you 
have performed BCD as described in the communications installa- 
tion documents prior to performing ALGS. 

3.5.1 Executing the ALGS Command 

Issue the ALGS command. The following prompts appear on the screen: 

ASSEMBLE AND LINK GENERATED SYSTEM 



DATA DISK 

TARGET DISK 

SYSTEM NAME 

D$DATA LISTING 

BATCH LISTING 



DS01 
DS01 
TEST 



Respond to the prompt DATA DISK with the device name or volume name of the disk or disk drive 
that contains the GEN990 output files. This is the same disk that you specify for the XGEN com- 
mand to use as the data disk. The GEN990 output files are stored under a directory 
.S$SYSG EN. < system name>, where < system name> is the name you assigned to the prompt 
OUTPUT CONFIGURATION for the XGEN command. 

The output of the ALGS command is sent to a system file S$IMAGES on the target disk. In 
response to the prompt TARGET DISK, enter the device name or volume name of the target disk. 

NOTE 

Prior to executing the ALGS command, verify that a .S$IMAGES 
program file exists on the target disk. If this program file does not 
exist, you must create it using the Create Program File (CFPRO) 
command. Refer to Volume II for a description of the CFPRO com- 
mand. Copy the procedure DUMMY from the existing .S$IMAGES 
program file to the one created using the Copy Program Image (CPI) 
command. 

Respond to the prompt SYSTEM NAME with the name of the output configuration assigned to the 
prompt OUTPUT CONFIGURATION for the XGEN command. 
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The value of the prompt D$DATA LISTING is the access name of a sequential file or output device 
to which the macro assembler output listing is written. The default access name follows this pat- 
tern: < data disk> .S$SYSGEN.< system name> .D$LIST. 

The value of the prompt BATCH LISTING is the access name of a sequential file or output to which 
the ALGS output listing is written. The default value is a pathname with the form <data 
disk> .S$SYSGEN.< system name> .ALGSLIST, such that < data disk> is the value that you sup- 
plied to the prompt DATA DISK and < system name> is the value you supplied to the prompt 
SYSTEM NAME. 

3.5.2 Results of the ALGS Command 

ALGS executes SCI in batch mode. The ALGS command stream executes a batch command 
stream (developed by GEN990 and stored in the file <data disk>.S$SYSGEN.< system 
name>.BATCHSTM) and sends a listing to the access name specified for the prompt BATCH 
LISTING. The batch command stream executes the Macro Assembler, the Link Editor, and a syn- 
onym assignment program that creates a patch file for the new system. 

The ALGS command requires from 15 to 30 minutes to execute, depending on the size and com- 
plexity of your computer system. 

3.5.2.1 Normal Termination. When the ALGS process terminates, a message appears at the 
terminal. If processing completes normally, the message is: 

*** ALGS NORMALTERMINATION *** 

Press the Return key. The following message appears: 

*** ALGS NORMALTERMINATION *** 

In this case, press the Return key and proceed by patching the generated system as described in 
paragraph 3.6. 

A successful ALGS execution creates the following files: 

A D$DATA object module output from the Macro Assembler in .S$SYSGEN.< system 
name>.D$OBJECT. 

A task image which is the linked system, in file .S$IMAGES on the target disk. 

A patch file (in the file .S$SYSGEN.< system name>.PATCHFIL) ready to be applied to 
the system image. 

A link map of the linked system in the file .S$SYSGEN.< system name> .LINKMAP. 

A file containing any error messages output by the patch generator in the file 
.S$SYSGEN.< system name> .ERROR 

An SCI batch listing, if you accept the defaults for the BATCH LISTING parameter, in the 
file .S$SYSGEN.< system name> .ALGSLIST. 
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3.5.2.2 Abnormal Termination. If ALGS does not terminate normally, one of the following error 
messages appears on the terminal screen: 

*** ALGS — D$DATA ASSEMBLY ERROR = <code> ***: 

*** ALGS — SYSTEM LINK EDIT ERROR = <code> ***: 

*** ALGS — SYNONYM GENERATOR FATAL ERROR = <code> ***: 

*** ALGS — SYNONYM GENERATOR NON-FATAL ERROR = <code> ***: 

where: 

<code> = a 4- or 5-digit condition code 

The first three error messages indicate unsuccessful completion of ALGS. The fourth error mes- 
sage indicates that a non-fatal error occurred and ALGS has successfully completed. If the fourth 
error message appears, proceed by patching the generated system as described in paragraph 3.6. 

If the first error message, D$DATA ASSEMBLY ERROR, appears, the error is a macro assembler 
error. The second error message indicates a fatal Link Editor error. The third error message indi- 
cates that a fatal error occurred in the synonym generator section of ALGS. 

You need to examine the batch listings created by the ALGS command to determine the cause of a 
fatal error. These two files contain the listings: 

• < data disk >.S$SYSGEN.< system name>.ALGSLIST — The batch SCI listing 

• <data disk >.S$SYSGEN.< system name>.D$LIST — The assembly listing of the new 
system's D$DATA module 

The last two lines of the batch SCI listing (ALGSLIST) contain the error messages that appeared 
on the terminal screen. Starting from the last line and working forward, inspect the batch SCI list- 
ing for the last SCI command listed. Between this point in the listing and the end is an error mes- 
sage and a 4-digit error code. Refer to Section 4. The following error codes may accompany the 
third error message: 

8001 — Module or synonym name too long 

8002 — Same synonym for different overlays 

8003 — Duplicate module 

C001 — Symbol too long 

C002 — Unexpected EOF on link map 

C003 — Too many modules 

C004 — Bad link map format 

Such errors indicate that the patch generator could not create a proper patch file from its input. If 
the software supplied by Texas Instruments has not been modified, see Volume VI. 
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3.5.3 ALGS Batch Stream 

The following example shows the batch stream executed by ALGS for a system called TEST on 



DS01 



IiiiirrrrrT*— "™ sysgen completion batch stream ===««=»====«=== 

***********************************************^;^^^^ 

******************** ASSEMBLE D$DATA ********************* 
**********************************************,m*^^^^^ 

BATCH ! 04/26/82-16:19:16 

XMA SOURCE = @$$DSCD.S$SYSGEN.TEST.D$SOURCE, 

OBJECT = @$$DSCD.S$SYSGEN.TEST.D$OBJECT, 

LIST - XMA$L, 

OPTION - (BUN, TUN, DUN) 
• SYN XMA$L ■ "" 
•IF @$$CC,GE, 04000 

CM R=ME,M="*** ALGS - D$DATA ASSEMBLY ERROR = @$$CC ***" 
•STOP T="*** ALGS - D$DATA ASSEMBLY ERROR ***" 
.ENDIF 

************************************************^^^^^^ 
******************* LINK THE SYSTEM ******************** 
**************************************************^ A ^^ 

XLE CONTROL- @$$DSCD.S$SYSGEN.TEST.LINKSTRM, 
LINK - <3$$DSC$.S$IMAGES, 

,„ «** LIST ■ @$$DSCD.S$SYSGEN.TEST.LINKMAP 
.IF @$$CC,GE, 04000 

SI^*!?:!*;!*** ALGS " SYSTEM LINK EDIT ERROR = @$$CC ***" 

™™°* T * ALGS " SYST EM LINK EDIT ERROR ***" 
•ENDIF 

************************************************************ 

I!!!!!!!****** RUN SYNONYM ASSIGNMENT PROG *************** 
*********************************************,**^^^^ 

XPS LINK = @$$DSCD.S$SYSGEN.TEST.LINKMAP, 

INPUT = @$$DSCP. PATCH. MEMRES, 

OUTPUT = @$$DSCD.S$SYSGEN.TEST.PATCHFIL, 

ERROR - <§$$DSCD.S$SYSGEN. TEST. ERROR 
.SYN $$CC = "@$XPS$E" 
.IF @$$CC,GT, 00000 

•SHOW @$ $DSCD.S$SYSGEN. TEST. ERROR 
•ENDIF 

.IF @$$CC,GE, 08000 

^•pS^'^riri? 58 I SYN0NYM GENERATOR FATAL ERROR = @$$CC ***» 
•ENDIF " SYN0NYM GENERATOR FATAL ERROR ***» 

•IF @$$CC,GT, 00000 

C ^Tnp M ?^r****™ GS I SYNONYM GENERATOR NON-FATAL ERROR = @$$CC * 
.ENDIF " SYN0NYM GENERATOR NON-FATAL ERROR ***" 

CM R=ME,M="*** ALGS - NORMAL TERMINATION ***" 
•STOP T="*** ALGS - NORMAL TERMINATION ***" 
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3.6 PATCHING THE SYSTEM 

After completion of ALGS, the patch file generated by ALGS must be applied to the new system 
before you can successfully perform an IPL Issue the Patch Generated System (PGS) command to 
direct DX10 to automatically apply the patches to the system. 

PATCH GENERATED SYSTEM 

DATA DISK 

TARGET DISK 

SYSTEM NAME 

BATCH LISTING 

Respond to the DATA DISK, TARGET DISK, and SYSTEM NAME prompts of this command with 
the same values as for the preceding ALGS command. The default value for the prompt BATCH 
LISTING is the file < data disk> .S$SYSGEN.< system name> .PGSLIST. 

The output of the PGS command is a usable DX10 image and the SCI batch listing. The PGS com- 
mand activates a batch SCI, which uses the patch file created by ALGS as input. The PGS process 
operates in background as ALGS does. If PGS terminates successfully, a successful completion 
message appears. After termination of PGS, the new DX10 image is ready to be installed and/or 
tested as the executing operating system. 

PGS will write error messages to the batch listing. Consult Volume VI for a description of any error 
messages. See the following paragraph for instructions on PGS error recovery. 

See Volume II for a description of the command and an explanation of the prompt responses. 
Appendix J lists an example patch file. 

3.6.1 PGS Error Recovery 

PGS generates one of four possible messages. If you receive the following message, the PGS 
command was successful: 

SYSTEM IS BOOTABLE 

If you receive the following message, the error count was nonzero and the patches were unsuc- 
cessful. You need to reissue the PGS command. 

SYSTEM IS NOT BOOTABLE 

The following message may also appear: 

SYSTEM ROOT EXCEEDS > C000 

The DX10 system tasks are loaded in the system at address >C000. A system in which the root is 
greater than > C000 in length will overlap the system tasks causing unknown results. 

The other message that may appear is as follows: 
LONGEST OVERLAY PATH EXCEEDS > F800 
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If the longest overlay path exceeds > F800, the system extends into the TILINE Peripheral Control 
Space (TPCS). Improper execution and possibly disk data destruction will occur. The system root 
length must be shortened. This can be accomplished by making the system table area smaller (re- 
fer to paragraph 3.4.3) or by removing some of the devices or additional capabilities (user SVCs). 
The latter choice in most cases is unacceptable, leaving reduction of the system table area the 
only means of making the system root smaller. Appendix I can be used as an aid in determining 
the new system memory requirements. 

3.6.2 Executing the Patch Synonym Assignment Program 

Occasionally, when installing the operating system from linked object, you may find it desirable to 
execute the patch synonym assignment program without assembling and linking the system 
again. Accomplish this using the Execute Patch Synonym (XPS) command: 

EXECUTE PATCH SYNONYM PROCESSOR 

LINK = [acnm] 

INPUT = [acnm] 

OUTPUT = [acnm] 

ERROR = [acnm] 

Table 3-11 lists the XPS prompts. The synonym $$DSC$ must be assigned the value of the disk 
drive name on which the system image is installed (that is, DS01 for the system disk). 

Table 3-11. XPS Command Prompt Responses 



Prompt 


Response Type 


Required or 
Optional 


Default 
Value 


Example 


LINK 


acnm 


R 


NONE 


.S$SYSGEN.TEST.LINKMAP 


INPUT 


acnm 


R 


NONE 


.PATCH.MEMRES 


OUTPUT 


acnm 


R 


NONE 


.S$SYSGEN.TEST. PATCH Fl L 


ERROR 


acnm 


R 


NONE 


.SSSYSGEN.TEST.ERROR 
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NOTE 

The message DIFFERENT SYNONYMS FOR SAME OVERLAYS is 
an informative warning, not a fatal error. 

3.6.3 Batch Stream Error Counter Errors 

Errors encountered by commands in batch streams are collected by using the Batch Stream Error 
Counter (EC) command. This command tests the value of the synonym $$CC, which is set by calls 
to S$STOP. When the value of $$CC is not zero, an error accumulation synonym, $E$C, is incre- 
mented by one. The value of $E$C may subsequently be displayed using the Create Message (CM) 
command. 

3.6.4 Clear Secret Synonyms 

Synonym table overflow errors occur when the synonym table reaches its capacity. System- 
defined synonyms and user synonyms share the same table area. Delete the system-defined 
secret synonyms using the Clear Secret Synonyms (Q$SYN) command. Issue a Show File (SF) 
command on .S$PROC.Q$SYN to inspect the synonyms cleared by the Q$SYN command. 

3.7 TESTING THE SYSTEM 

We strongly advise that you test the new system before installing it as the primary system. To test 
the new system, issue the TGS command. The following prompts appear on the screen: 

TARGET DISK: 
SYSTEM NAME: 

Respond to the prompts with the same values established in the preceding PGS command. 

The TGS command designates the system under test to be the secondary system. The next time 
that an IPL occurs, this secondary system is loaded as the operating system. On subsequent IPLs, 
the primary system is loaded. This offers you an opportunity to ensure that the generated system 
will load successfully and function as designed. The following example displays a typical output 
from PGS using the imaginary systems S$SUP and ITGS: 

IGS/TGS 
PAE5 SYSTEM IPL STATUS 

PRIMARY SYSTEM = S$SUP SECONDARY SYSTEM = ITGS 

TEST SECONDARY SYSTEM 

If the secondary system does not act as expected, you can perform an IPL and the primary system 
will be loaded. Then you can repeat the system generation procedure for the system. If the sec- 
ondary system functions properly, install it as the primary system using the IGS command as 
described in the following paragraph. 
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3.8 INSTALLING THE GENERATED SYSTEM 

Issue the IGS command to install the system entered for the SYSTEM NAME prompt as the pri- 
mary system. The prompts and responses are the same as for TGS: 

TARGET DISK: 
SYSTEM NAME: 

The following example displays a typical output of the IGS command: 

IGS /TGS 
PAE5 SYSTEM IPL STATUS 

PRIMARY SYSTEM = ITGS SECONDARY SYSTEM = S$SUP 

IPL ON PRIMARY SYSTEM 
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4.1 INTRODUCTION 



This section provides useful advice for the person responsible for maintaining a system. In par- 
ticular, this section concerns rectifying a faulty system generation, but the advice is useful in 
troubleshooting any crash, if for no other reason, then to determine that the fault does not lie in 
the system generation. 

4.2 MAINTAINING A SYSTEM LOGBOOK 

Make it a practice to keep a logbook of what happens to the system. Record all changes made to 
the system and ail unexpected behavior. The following list contains typical entries to a logbook: 

New system generations 

Installation of patches 

Installation of new hardware 

Repairs to hardware 

Which disk packs were in use when disk and/or controller related problems were noticed 

Which disk packs were in use when the system crashes 

What the crash codes were 

Installation of new application software 

Modifications to application software 

When application problems occurred and what the error codes and messages were 

The resolution to any problem 

Changes to the system are primary clues to the initial direction of investigation. Coincidence of 
problems with other operations on the system also gives important clues. Changes in system 
behavior without a change in software are important clues to possible hardware problems, and 
the error codes are the system's primary method of communicating its problems to you. 
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4.3 TROUBLESHOOTING SYSTEM GENERATION PROBLEMS 

Problems with system generation fall generally into three classes: 

• Problems with mistyped interrupts and controller addresses, which cause hangs and 
crashes 

• Problems relating to the various components of system table area, their sizes, and how 
they affect the operation of the system 

• Problems with operations, usually with getting the Assemble and Link Generated Sys- 
tem (ALGS) and Patch Generated System (PGS) commands to execute properly 

The text below is arranged by external symptoms. The titles are meant to match the visible mani- 
festation of the problem. Find the paragraph title that most closely matches the symptom of your 
problem. If you cannot isolate a problem by the procedures below in a reasonable amount of time, 
obtain software help before calling for hardware service. 

Sometimes a problem with a system generation may be coincident with a hardware problem, or a 
hardware problem may develop that manifests itself at the next initial program load (I PL). In the 
DX10 documentation, the primary characteristic of hardware problems is called essential random- 
ness (defined in Section 8 of DX10 Error Reporting and Recovery Manual, Volume VI). One purpose 
of the following text is to define essential coincidence as it differs from essential randomness and 
to describe the essential coincidences that indicate problems with system generation. 

4.3.1 Crashes and Hangs 

Crashes and hangs are abrupt indications that something may be wrong with the system genera- 
tion. The following characteristics describe a crash: 

• The system becomes inoperative; your data terminal does not respond to your input. 

• The fault light on the front panel is lit. 

• A crash code appears on the front panel. 

The system is also inoperative during a hang. A hang differs from a crash in two ways: 

• The fault light is not lit. 

• No crash code appears on the front panel. The bar chart display of CPU and disk activity 
shows 100% activity or simply does not change at all. 

The problem must be coincident with a new system generation to be associated with that system 
generation. However, if a device is defined during system generation but not accessed during IPL, 
a system generation problem with that device may not show itself until that device is accessed, 
but it will always appear when that device is first accessed. If the problem appears randomly, con- 
sult the troubleshooting guide in Volume VI. 
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If the crash always happens during IPL and is > 1 F or less, the cause of the crash is a system gen- 
eration problem. DX10 Releases 3.3 and earlier cannot have a crash code less than > 20. In these 
releases, issue the Analyze DX10 Crash File (XANAL) command to execute the ANALZ utility and 
use the General Information (Gl) command to obtain the contents of the status register at the time 
of failure. Add one to the value of the rightmost digit to calculate the interrupt level that is 
assigned to something defined incorrectly during system generation. (If the result is 2, the prob- 
lem is not system generation related.) When working with DX10 Release 3.4 and later, subtract 
> 10 from the crash code to calculate the interrupt level assigned to something incorrectly defined 
during system generation. In Release 3.4 and later, the crash code cannot be less than > 13. 

If the crash always occurs when a particular device is accessed, but not at IPL, the cause of the 
crash is probably due to a fault in the definition of that device during system generation. If it is not 
a system generation definition problem, the cause could be a miswired interrupt jumper plug in 
the chassis or a broken controller board. 

Hangs occur when a device is accessed and the interrupt/address pair do not match. A hang 
appears during IPL on devices that interrupt when initialized by the power-up sequence of the 
device service routine (DSR), and at first access on other devices. If a system generation problem, 
it will always appear when the same device controller is accessed. Like the crash, if it is not a sys- 
tem generation problem, it is a miswired interrupt jumper plug or a broken controller board. 

A hang requires some analysis to determine the interrupt level involved. With the CPU in hung 
condition, press HALT, then ST under DISPLAY. This causes the value of the status register to 
appear on the 16 data lights on the front panel. Note the value of bit 8. If bit 8 is on, the hang is in a 
task and the problem is not related to interrupts or addresses mistyped during system generation. 
If bit 8 is off, note the contents of bits 12 through 15. Press RUN, then repeat the process. A hang 
caused by a faulty system generation will show one interrupt level consistently. If other interrupt 
levels are displayed, sample the status register several times to determine which interrupt level 
occurs most frequently. One level should stand out clearly. Add one to the value of bits 12 through 
15 to obtain the interrupt level of the problem device. 

If one level does not stand out, the problem may not be a faulty system generation. Before check- 
ing for other problems, check on other devices. A lower level (higher priority) device may be inter- 
rupting frequently enough to superimpose its normal behavior on the problem level. This will 
cause the other interrupt level to also show up; you may want to investigate both levels for a sys- 
tem generation problem. A level consistently showing up as 4 may mean that there is a hardware 
malfunction in the realtime clock. Consistent appearance of level 15 with bit 8 set high means the 
hang is in a task. If the level shows 1 or below, the system's memory may have been changed 
affecting the system's ability to handle error conditions. In the latter case, it is often not possible 
to force a crash dump. Call your dealer for help with this software problem. 

If the crash or hang occurs randomly after the system is up and running, and the device indicated 
by the analysis above has been successfully accessed— or at least accessed and a different error 
occurred— the problem is probably not the system generation. The cause of the problem is more 
likely to be a malfunctioning controller board or an intermittent problem in the interrupt wiring. 

Sometimes the problem is at an interrupt level where an expansion chassis is defined. In this 
case, consult the troubleshooting guide in Volume VI. Refer to paragraph titled Continuous Inter- 
rupts to determine the chassis position of the problem device. Again, suspect a system genera- 
tion problem only if the problem always happens during IPL or when a particular device is 
accessed. 
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A hang can also occur when two devices are defined during system generation to have the same 
interrupt (in the main chassis) or the same position (in an expansion chassis) where one device is 
in use and no controller board is installed for the other device. The solution is to do one of the 
following: 

• Remove all controller boards that share the interrupts or position. 

• Perform another system generation, defining only those controllers present. 

• Install the missing controller board in the affected chassis. 

4.4 OTHER SYSTEM GENERATION PROBLEMS 

Occasionally, the following problems arise when running applications and/or system utilities 
whose solutions require system generation changes. 

• Supervisor call (SVC) error > 05 

• SVC error >0E (to be distinguished from an error >000E that can happen with a defec- 
tive SCI command procedure that calls a COBOL program) 

• SVC error > 89 

4.4.1 SVC Error > 05 

SVC error > 05 has three causes: 

• The user program has made an SVC in which the call block itself, or the associated data 
buffer, extends outside the range of memory the task has for its use. This condition is 
usually regarded as a bug. 

The user program has made an Assign LUNO call with a pathname too long. This condi- 
tion can arise in programs that construct their own pathnames, such as the Copy Direc- 
tory (CD) utility. In that case, the problem is usually that an output disk volume has been 
used whose name is long enough for marginal pathnames to "spill over" and cause the 
problem. 

• Physical record and/or logical record too long when accessing key indexed files (KIFs). 
Treat this error as you would SVC error > 89 since the cause is the same. 

4.4.2 SVC Error > 0E 

This error has only one cause: the additional I/O buffer area defined for the system during system 
generation is not sufficient to support the I/O that the system is being asked to handle. Fix this 
problem by enlarging that parameter during system generation. GEN990 (the System Generation 
utility) itself may not allocate sufficient I/O buffer area. The parameter ADDITIONAL I/O BUFFERS 
is added to what GEN990 calculated, and so increasing this parameter should fix the problem. 

If the problem does not respond to this fix, or you have included communications packages in the 
system generation and the problem occurs when the communication package is inactive some- 
thing else is causing the >0E error. Check the possible COBOL cause mentioned above and, if 
that is not the problem, obtain software help. 
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4.4.3 SVC Error > 89 

This error is caused by having a combination of physical record length and logical record length 
too great for the file management processor to map into its address space. The following discus- 
sion explains Figure 4-1. 



NOTE 

Map reg 1 refers to the first of three segments, not to one of the map 
files of the CPU. 



FILE MANAGER 
LOGICAL 
MEMORY 



>0000 

k 



MAP 
REG 

1 



MAP 
REG 



f " 



MAP 

REG 

3 

>FFEO 



SYSTEM ROOT - INCLUDES TABLE AREA 



FILE MANAGER CODE - PHYSICALLY 
JUXTAPOSED TO ROOT TO GIVE 2 
MAPPING SEGMENTS TO FILE 
MANAGER FOR MANAGING BUFFERS 
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BB - KIF 
UB - FM 



UB - KIF 
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BB = BLOCKING BUFFER 
UB - USER BUFFER 
FM -- FILE MANAGER 
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Figure 4-1. Memory Used by File Management 
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From Figure 4-1, it can be seen that the length of the system root directly affects the size of physi- 
cal and logical records that the system can handle. 

To calculate the amount of address space file management has to use for file blocking, inspect 
the system link map from .S$SYSGEN and locate the phase with the module FILMG in it. Perform 
the following steps: 

1 . Add the length and origin of the phase together and round up to a beet boundary. 

2. Add > 40 to the sum. 

3. Subtract the result of step 2 from > FFEO. The difference is the blocking space. 

The blocking space can be used for logical records and physical records of any size ratio so long 
as the sum of the two does not exceed blocking space. File management only maps in one block- 
ing buffer and one logical record at any given time. Therefore, no "double blocking" occurs with 
small physical and logical records. In the event that blocking space is exceeded, you get a >5 or 
>89 error depending on which buffer is mapped into map segment 3. If the blocking buffer is 
mapped to map segment 3, an > 89 error occurs. If the user buffer is so mapped, a > 5 error occurs. 

There are three basic ways to solve this problem: 

• Reduce the physical record size of the file. 

• Reduce the logical record size used by the program in its Read I/O SVC. 

• Make the system root smaller (by reducing table area or eliminating devices and 
optional features). 

• Make file management smaller by eliminating KIF. 

4.5 ALGS AND PGS PROBLEMS 

The most common operational problem with system generation is a Q$SYN SCI command on the 
system that clears the synonyms used to pass information from the ALGS command or the PGS 
command to the batch stream that does the work. If those synonyms are being cleared, inspect 
the Q$SYN command procedure, the BATCH command procedure, the Execute Batch (XB) com- 
mand procedure, and the M$00 command procedure for a .SYN or Assign Synonym (AS) command 
that clears the synonyms set by the ALGS or PGS commands. All of these are invoked during exe- 
cution of the ALGS and PGS commands. Other problems are insufficient disk space to complete 
the system generation, the S$SYSGEN directory is full, and the S$IMAGES program file is full. The 
error messages returned by GEN990 and the Link Editor will indicate these problems. 

If the error was in the macro assembler process, inspect the listing file given for the D$DATA 
LISTING prompt and determine which statements failed. If a numeric error code appears, you can 
find an SVC error code in the two digits on the right. Check for missing files, full directory, full 
disk, and unassigned synonyms. These problems require you to provide the file, create space, or 
assign synonyms. If a macro expansion error occurs, determine if the macro at fault was supplied 
by TJ or by the vendor of a non-TI software package. Contact the appropriate supplier or supplier's 
representative for assistance. 
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If the error occurred during the Link Editor processing, inspect the file <data 
disk>.S$SYGEN.< system name>.LINKMAP to determine the errors. Check for the same things 
mentioned in the macro assembler process and also fot Install Task and Install Overlay SVC errors. 
The message ADDRESS SPACE OVERFLOW means that the system is too large; in this case, the 
length of phase may not be correct. Locate the longest phase 2 in the link map and add its origin 
to its length. Subtract >F800 from the result. Make the system table smaller by this number and 
perform another trial ALGS to see if further tuning is necessary. 

4.6 BUILDING A NEW SYSTEM DISK 

Another common problem occurs when building a new disk. If you initialize the new disk using the 
Initialize New Volume (INV) command and accept the default value of NO for the USED AS 
SYSTEM DISK? prompt you cannot successfully use that disk as a system disk. If you specify 
such a disk as the TARGET DISK during system generation, errors occur that indicate that the 
directory .S$SYSGEN is missing, that the .S$IMAGES program file is missing, or, if SSIMAGES is 
present, something is wrong with it. Typically the latter appears as a Link Editor error. Create an 
S$SYSGEN directory (it need contain no files); create SSIMAGES and copy the DUMMY procedure 
from an operational SSIMAGES. Other files must also be copied to make a running system. They 
currently are: 

S$PROGA 

SSLOADER 

S$PROC 

SSOVLYA 

S$SDS$ if the assembler, Link Editor, and other software installed there are needed 
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5.1 INTRODUCTION 

DX10 supports a variety of peripheral devices by providing device service routines (DSRs) tailored 
to their requirements. If you wish to add a nonstandard device to your DX10 system and no 
standard DSR satisfies your needs, you must provide it with a DSR as well as the associated data 
structures and interrupt handling routines. 

This section supplies the information you need for adding support for a nonstandard device to the 
DX10 operating system. It begins with a discussion of I/O request processing and the DSR entry 
points needed to handle the various types of interrupts. It then describes the data structures 
employed by the DSR and the coding conventions used for DX10 DSRs. The section then dis- 
cusses the asynchronous DSR structure and the subroutines provided to simplify asynchronous 
DSR coding. It concludes with explanations of the common routines provided with DX10 to sim- 
plify DSR coding for both regular DSRs and asynchronous DSRs. Figure 5-22 contains two 
examples of DSRs. 

NOTE 

There is no programmed limit on the number of special devices that 
can be defined to use a DSR. However, DX10 supports a maximum 
of 16 special DSRs. Each of the DSRs will be placed in its own map 
segment. 

Before you begin, you should have a good understanding of the following topics: 

Hardware interface for the device. 

Interrupt handling. Refer to paragraph 5.2.5. 

Device data structures. Refer to paragraph 5.3. 

Computer hardware. Refer to the appropriate hardware manuals for your system. 

990 assembly language. Refer to 990/10 and 990/12 Assembly Language Reference 
Manual. 

DX10 system generation. Refer to Section 3. 
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5.2 DEVICE SERVICE ROUTINES (DSRs) 

DSRs provide the interface between peripheral devices and tasks running on the 990 computer. A 
task initiates a device operation by performing an I/O supervisor call (SVC). The I/O supervisor 
transfers control to the DSR for the device, along with a pointer to information from the SVC. The 
DSR processes the SVC data, usually by sending an instruction to the device. Then it returns con- 
trol to the I/O supervisor while waiting for the device to respond by generating a coded signal— an 
interrupt. When it receives an interrupt, the DX10 interrupt handler decodes the signal and trans- 
fers control back to the DSR. The DSR processes the interrupt and returns control to the I/O man- 
ager to wait for the next interrupt. After the DSR completes the SVC, it calls the ENDRCD routine 
(refer to paragraph 5.7.3), allowing the task to resume execution. Figure 5-1 illustrates this 
process. 

When you write a DSR, you must provide routines to handle SVC calls and device interrupts. You 
must also supply routines for aborting device I/O and for initializing the data structures and/or the 
device during the initial program load (IPL). Optionally, you can include additional routines for 
internal use by the DSR. Figure 5-2 shows where to place the routines in the DSR and the follow- 
ing paragraphs explain their functions in detail. Subsequent discussions deal with the data struc- 
tures used by the DSR, DSR coding conventions, and the common subroutines provided with DX10 
to simplify DSR coding. The section concludes with two example DSRs. 

5.2.1 I/O Call Routine 

When the I/O supervisor receives an SVC for the device, it first makes a copy of the call block 
(buffers it) in the system table area. (Buffering is discussed in paragraphs 5.3.3 and 5.4.4.) Next it 
transfers control to the I/O Call routine in the DSR. This routine initiates the processing of the 
SVC, using the SVC data provided by the I/O supervisor. This usually involves decoding the SVC 
subopcode, taking the appropriate action, and returning control to the I/O supervisor. Typical 
subopcodes are Open, Close, Read, and Write. The characteristics of the device determine the 
actual processing required. 

5.2.1.1 Entry Point. The I/O Call routine begins at the third word in the DSR. (The first and sec- 
ond words point to the Power Restored and I/O Abort routines.) 

5.2.1.2 Workspace. The workspace used for the I/O Call routine is the physical device table 
(PDT) workspace for the device. This workspace contains the values shown in Figure 5-5 and 
described in paragraph 5.3.1. Using this information, you can access the SVC block for the call 
and address of the controller. You can use registers R5 through R11 for DSR working storage. 

5.2.1.3 Processing. The operating system calls this routine with a BLWP instruction. That 
instruction always executes one instruction in the new context. (Consult the 990/10 and 990/12 
Assembly Language Reference Manual for a complete description of how BLWP works.) This 
instruction can be a LIMI 2 to mask all but level 1 interrupts preparatory to calling SETWPS, which 
sets the interrupt mask to the value defined in R2 of the PDT workspace. Prior to entry, the I/O 
supervisor sets the busy flag in the PDT (bit 1 of PDTDSF), which prevents entry to the DSR if 
another request for service occurs before the current one completes. The operating system 
queues such requests and then makes a new call to the DSR for all the queued requests. 
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Figure 5-1. Flow of an I/O Call 
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Figure 5-2. DSR Structure 
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The value in R2 of the PDT workspace is defined during system generation by GEN990. You can 
choose to inhibit interrupts of varying levels, as noted below: 

You can use a mask value of 2, which inhibits all interrupts except power-down, power- 
up and machine error (for example, illegal instruction). This is seldom necessary and is 
undesirable because all other interrupt activity of higher priority than necessary is also 
inhibited which could cause other devices to receive timing errors. 

• A mask value of one less than the value defined for the device during system generation 
is used when the PDT workspace is also used for interrupt processing. This is the high- 
est priority interrupt that must be masked to prevent the interrupt service routine (ISR) 
from being entered before initialization is complete. 

• A mask value of > F allows all interrupts. This allows all other interrupts to be serviced, 
and may be useful because it will not cause timing errors to appear on any other device. 
If you elect to use this mask value, you allow the ISR to be entered at any time, including 
when the DSR may be processing an I/O SVC call. You must take precautions to ensure 
that the DSR and the ISR do not access their common data structures in a conflicting 
manner. This usually requires inhibiting interrupts to a level one less than the level the 
device is connected to during the time common data is being accessed. A DSR written 
to use this convention must use an interrupt workspace that is separate from the PDT 
workspace, usually the keyboard status block (KSB). 

A response of NONE to the INTERRUPT? prompt during system generation causes a 
mask value of > F to be generated. You should use it for a device that does not generate 
interrupts. 

If the SVC contains a subopcode (sometimes called the I/O opcode), you can use the BRCALL or 
JMCALL routines to process it. BRCALL (paragraph 5.7.1) employs a branch table to transfer con- 
trol to the appropriate routine within the DSR. JMCALL (paragraph 5.7.6) uses a jump table for the 
same purpose. When you use these routines, you must provide the branch table or jump table 
immediately after the call. The remainder of the I/O Call routine can consist of processors for the 
individual subopcodes and for error conditions. The I/O Call routine should terminate by executing 
an RTWP instruction. 

5.2.2 Shared Routines . 

Following the I/O Call routine and subopcode processors, you might want to include one or more 
common routines. These shared routines can perform operations common to the subopcode pro- 
cessors or the other required routines. 

5.2.3 Power Restored Routine t „„. n , 
The Power Restored routine handles device initialization after the loading of DX10 or a power loss 
and recovery. In particular, it should call the I/O Abort routine whenever it finds an I/O request was 
pending at the time of a power failure. As shown in Figure 5-2, the Power Restore routine follows 
any shared routines included in the DSR. 
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5.2.3.1 Entry Point. The address of the Power Restored routine must be defined in the first 
word of the DSR. You do this by coding a DATA statement with the label of the first instruction in 
the Power Restored routine as the operand. 

5.2.3.2 Workspace. When the routine is called, the workspace pointer (WP) register points to 
the PDT workspace for the device. You can use registers R5 through R11 in the PDT as scratch 
registers. 

5.2.3.3 Processing. The Power Restored routine has two main responsibilities. First, it must 
initialize the device following a system load or power-up. How you do this depends on the charac- 
teristics of the device. Second, it must abort I/O when an I/O request was pending at the time of a 
power failure. You can use the common system routine, B2YCHK, to determine whether an I/O 
request was pending. If so, the Power Restored routine should call the DSR I/O Abort routine. If 
not, the routine should return control with an RTWP instruction. 

5.2.4 I/O Abort Routine 

When DX10 times out a device or executes an Abort I/O SVC, the I/O supervisor removes all physi- 
cal record blocks (PRBs) from the queue for the device. Then it transfers control to the DSR at the 
entry point for the I/O Abort routine. This routine terminates the current I/O request and places the 
appropriate error code in the SVC block. 

5.2.4.1 Entry Point. The address of the I/O Abort routine must be defined in the second word of 
the DSR, immediately after the address of the Power Restored entry point. You code it using a 
DATA statement with the label of the first instruction in the I/O Abort routine as the operand. 

5.2.4.2 Workspace. When the routine is called, the WP register points to the PDT workspace for 
the device. You can use R5 through R1 1 as scratch registers. 

5.2.4.3 Processing. The I/O Abort routine has the responsibility of terminating the processing 
of the request and posting an appropriate return code in the buffered I/O request block. It should 
also perform whatever initialization of the device is necessary to restore it to a known state. 

If necessary, you can use the communications register unit (CRU) orTILINE address in R12 of the 
PDT workspace to inspect any status bits that may be available from the device. The error code 
returned to the calling task goes in PRBEC of the buffered I/O request block, which you address as 
@PRBEC(R1). The routine should report device errors to the system log by placing a nonzero error 
code in PDTERR of the PDT. It should also record the status of the device by setting bit 14, the 
Operation Failed flag, in PDTFLG. The routine should conclude with an RTWP instruction to return 
control to the I/O supervisor. 
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5.2.5 Interrupt Service Routine (ISR) 

The 990 computer uses a vector table to handle up to 16 levels of interrupts. When the interrupt 
hardware detects an interrupt, it uses the table to transfer control to the interrupt handler or 
decoder (created by GEN990 during system generation) that processes the interrupt. Each transfer 
vector consists of two 16-bit words. The first contains the address of the workspace area for the 
interrupt, and the second contains the address of the entry point of the interrupt handler that ser- 
vices the interrupt. The computer hardware automatically uses map file to access the interrupt 
vector. 

Interrupt levels range from through 15, with being the highest priority and 15 the lowest. Bits 12 
through 15 of the status register (ST) form an interrupt mask, whose value determines the lowest 
priority (highest numbered level) interrupt allowed. The 990 computer continuously compares the 
level of the highest pending interrupt request to the current value of the interrupt mask, honoring 
only interrupts with equal or lower levels than the mask. The processor hardware always finishes 
the current instruction before transferring control to the ISR. 

When the CPU has a pending interrupt with an equal or lower level than the interrupt mask, it 
saves the current WP, program counter (PC), and ST registers. It changes to map file 0, subtracts 
one from the level of the interrupt, and places the result in the interrupt mask of the ST. Then, it 
multiplies the interrupt level by 4 to compute the memory address of the interrupt vector. It stores 
the WP PC and ST registers at the time of the interrupt in R13, R14, and R15 of the workspace 
pointed to by the WP component of the interrupt vector. Then, it loads the WP and PC registers 
with the values in the interrupt vector and executes one instruction regardless of any pending 
interrupt or the value of the interrupt mask. Then, it resumes normal execution. This process trans- 
fers control to the interrupt decoder built by GEN990. The interrupt decoder determines which 
interrupt workspace and entry address are associated with the device and enters the DSR using a 
BLWP instruction. Interrupt processing proceeds, and when it is complete, the ISR returns with an 
RTWP instruction. The interrupt decoder then enters the interrupt cleanup routine in DX10, known 
as trap return. 

GEN990 produces both the interrupt vector table and the interrupt decoder, according to your 
responses to its device definition prompts. The interrupt decoder takes care of such things as 
shared interrupts and expansion chassis interrupts. You can provide your own vector table and 
interrupt decoder, if you prefer, but you will also have to replace the ones built by GEN 990. To do 
this you can tailor the source file built by GEN990 (.S$SYSGEN.<sysname>.D$SOURCE) to the 
requirements of your device. It is usually better to let GEN990 produce the interrupt table and then 
perform additional decoding in the ISR. Table 5-1 provides an example of an interrupt vector table. 
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Memory 
Address 



Notes: 



Table 5-1. Example Interrupt Vector Table 



Interrupt 
Vector 



0000 





0002 





0004 


1 


0006 


1 


0008 


2 


000A 


2 


oooc 


3 


000E 


3 


0010 


4 


0012 


4 


0014 


5 


0016 


5 


0018 


6 


001 A 


6 


001 C 


7 


001 E 


7 


0020 


8 


0022 


8 


0024 


9 


0026 


9 


0028 


10 


002A 


10 


002C 


11 


002E 


11 


0030 


12 


0032 


12 


0034 


13 


0036 


13 


0038 


14 


003A 


14 


003C 


15 


003E 


15 



Vector 
Contents 



WP address for interrupt 

PC address for interrupt 

WP address for interrupt 1 

PC address for interrupt 1 

WP address for interrupt 2 

PC address for interrupt 2 

WP address for interrupt 3 

PC address for interrupt 3 

WP address for interrupt 4 

PC address for interrupt 4 

WP address for interrupt 5 

PC address for interrupt 5 

WP address for interrupt 6 

PC address for interrupt 6 

WP address for interrupt 7 

PC address for interrupt 7 

WP address for interrupt 8 

PC address for interrupt 8 

WP address for interrupt 9 

PC address for interrupt 9 

WP address for interrupt 10 

PC address for interrupt 10 

WP address for interrupt 11 

PC address for interrupt 1 1 

WP address for interrupt 12 

PC address for interrupt 12 

WP address for interrupt 13 

PC address for interrupt 13 

WP address for Interrupt 14 

PC address for interrupt 14 

WP address for interrupt 15 

PC address for interrupt 15 



1 Level is always the Power On/Up interrupt. 

2 Predefined interrupts in the 990/10 and 990/12. 

3 Typical interrupt levels for standard devices. 



Typical 
Assignment 



Power On 1 

Power Failing 2 

Error 2 

External Device 

(Communications) 3 

External Device 

(Card Reader) 3 

Line Frequency Clock (optional) 3 

External Device 

External Device 

External Device 

External Device 
(Mag Tape) 3 
External Device 
(CRT) 3 

External Device 
(CRT) 3 
External Device 

External Device 
(Disk) 3 
External Device 

External Device 



?h1" rb fn !Z h! h GEN9 90 'ssues the INTERRUPT ENTRY prompt to obtain the entry point of 

ZVrf^r hL h s ° e 5 ? mg defmed ' ll P,aces the address of the ISR in the tables that the interrupt 
handler (decoder) uses to enter the ISR after it determines which DSR is to service the interrupt 

The routine beginning at the specified entry point must handle all interrupts for the device. 
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5 2 5 2 Workspace. GEN990 issues the DSR WORKSPACE prompt to obtain the location of the 
workspace for the ISR, usually PDT workspace in bytes 4 through 23 of the PDT. R5 through R11 
are available for use by the DSR. You must not destroy the contents of the other PDT workspace 
registers. 

For multiple device controllers, the ISR should use a separate workspace for decoding the inter- 
rupts instead of the PDT workspace. This workspace can be part of an extension to the PDT for the 
first device (which you define to suit the needs of the device). The workspace can also contain 
pointers to the PDT workspaces used by the DSR if needed. 

For DSRs that service keyboard devices, the ISR should use the workspace in the KSB (paragraph 
5.3.2) extension to the PDT. Some of the common routines (paragraph 5.7) used by keyboard DSRs 
use the KSB workspace. 

5 2 5 3 Processing. Figure 5-3 illustrates the processing done by the ISR. You should design 
the ISR code to be reentrant, so that it can serve multiple devices of the same type. All data that 
the ISR changes must be in the PDT or its extension for the device being serviced. The ISR must 
service each interrupt very quickly. 



Hardware Interrupt 



i 



Initialize 
Time-Out 



Decode 
Interrupt 



Input 



Output 



Error 



Timing 



n 



Status 



• •• 
Interrupt Processors 



2279423 



Return To 
System 
(RTWP) 



Figure 5-3. ISR Processing 
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The ISR should begin by resetting the time-out counter for the device. To do this, move PDTTM1 to 
PDTTM2. You should do this even if you do not choose the time-out option during system 
generation. 

Complex devices, such as interactive terminals or multiple-device controllers, require special 
treatment: 

The Keyboard ISR must be able to handle unsolicited characters as well as those gener- 
ated in response to an I/O SVC. By using the routine PUTCBF, the system places charac- 
ters into the KSB character queue. Event characters are handled the same way usinq 
the routine PUTEBF. 

• If the characters read from the device interface do not fit the function table in Volume III, 
or the event/data character ranges defined for GETC, the ISR may need to transform 
those characters into character codes compatible with those functions. If so, it should 
perform the transformation before calling PUTCBF or PUTEBF. These character func- 
tions and character ranges are set by convention and you need to hold to the convention 
only if you need to use other parts of DX10 (such as SCI) that use that convention. 

For multiple-device controllers, the ISR should first use the workspace in the extension 
to the PDT to determine which device generated the interrupt. Then, use a BLWP 
instruction to enter the DSR with the workspace of the PDT for that device and process 
the interrupt. It should conclude with a RTWP instruction to return to the interrupt 
decoder. Figure 5-4 shows a specific configuration for a multiple disk drive controller. 
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5.3 DATA STRUCTURES 

The DSR uses several data structures maintained by DX10. These data structures can be found in 
.S$SYSGEN.SYSTEM.TABLES. This paragraph describes the contents and use of these data struc- 
tures: 

Physical device table (PDT) — Characteristics and status of a device, and some working 
storage. 

Keyboard status block (KSB) — Supplement to the PDT for keyboard devices. 

PDT workspace — I/O call information passed to the DSR. Do not depend on the PDT 
workspace registers to maintain status of a device from one I/O call to the next. 

Buffered I/O request block — Information from the I/O SVC block available to the DSR. 

Task status block (TSB) — All the information the system needs to know about tasks. 

Extension for terminals with keyboards (XTK) — Extension used by Tl DSRs for 
terminals. It functions as an extension to the KSB. 

Asynchronous DSR local PDT extension — The local (system table area) PDT extension 
for the asynchronous DSR. 

Asynchronous DSR long-distance device extension — A second PDT extension area 
accessed via long-distance instructions by the asynchronous DSR. 

Any extension you may define to contain data related to the device. 

This section does not provide details on the entire I/O SVC block, since it receives a thorough 
explanation in the Volume III. 

5.3.1 Physical Device Table (PDT) 

The PDT represents a device to the DX10 operating system. It describes the current state and char- 
acteristics of the device, provides a workspace for the DSR, and holds the queue anchors for I/O 
requests for the device. Figure 5-5 shows the structure of the PDT. For a description of the PDT 
extensions for standard devices, refer to the DX10 System Design Document. 

You must provide a PDT for each device you add to the system. 

Some of the fields are reserved and receive their initial values from GEN990 or the I/O scheduler. 
You must provide the initial values for other fields. You must provide space for all the fields in the 
PDT, since the operating system accesses data by its position from the beginning of the PDT. 
Table 5-2 describes the PDT fields. 
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HEX 
BYTE 




> 00 




>02 




>04 


R0 


>06 


R1 


>08 


R2 


>0A 


R3 



>0C R4 



>0E 


R5 


>10 


R6 


>12 


R7 


>14 


R8 


>16 


R9 


>18 


RIO 


>1A 


R11 


>1C 


R12 


>1E 


R13 


>20 


R14 


>22 


R15 


>24 




>26 




>28 





>2A 

>2E 
>30 
>32 
>34 
>36 

>38 

>42 
>44 

>46 

>48 

2283068 
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PDTt-NK — FORWARD LINK TO NEXT PDT 



PDTMAP POINTER TO DSR MAP FILE 



POTRO — DSR SCRATCH 



PDTPRB — PRB ADDRESS 



PDTDSF — DEVICE STATUS FLAGS 



PDTDTF DEVICE TYPE FLAGS 



PDTDIB ■ — DEVICE INFO BLOCK ADDRESS 



PDTR5 

POTR6 

PDTR7 

PDTR8 

POTR9 

PDTR 1 

PDTR 1 1 



DSR SCRATCH 



POTCRU CRU OR T1LINE BASE ADDRESS 



PDTR 13 SAVED WP REGISTER 



PDTR 14 — SAVED PC REGISTER 



PDTR15 — SAVED ST REGISTER 



PDT$ — PDT WORKSPACE ADDRESS 



POTDSR — DSR ADDRESS 



PDTERR ERROR CODE 



PDTFLG — FLAGS 



PDTNAM — DEVICE NAME 



PDTSL1 — SYSTEM LOG 1 



PDTSL2 — SYSTEM LOG 2 



POTBUF — NOT USED 



PDTBLN BUFFER LENGTH 



POTINT DSR REENTER-ME ADDRESS 



PDTDVQ DEVICE QUEUE ANCHOR 



PDTTM1 TIME OUT COUNT 1 



PDTTM2 -- TIME OUT COUNT 2 



PDTSRB — SAVED PRB ADDRESS 



POTFQL - - PRIORITY DSR SCHEDULE QUEUE WORD 



Figure 5-5. PDT Structure 
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Table 5-2. PDT Values 



Hex. 
Byte 



Field 
Name 



Description 



>00 

>02 
>04 



PDTLNK 

PDTMAP 
PDTRO 



>06 R1 PDTPRB 
>08 R2 PDTDSF 

DSFASG 

DSFBSY 

DSFINT 
DSFKLL 
DSFCLS 

DSFREN 

DSFEOR 
DSFJIS 



Address of the next PDT and the PDT expansion block for 
this PDT. All the PDTs are linked in a single list that is located 
in the D$DATA module. 

Address of the DSR map file. 

This word begins the PDT workspace to be used by the DSR 
I/O Call routine. 

Address of I/O opcode byte in buffered I/O SVC block. This 
register is updated prior to DSR entry from the I/O 
subsystem. 

Device status flags that are set by the system (bit 5 set by the 
DSR): 

Bit Meaning When Set 

Device is opened; that is, LUNOs are open to 
the device if it is file oriented. 

1 DSR is busy (that is, it is processing an I/O 
request). 

2 Kill I/O at this device is in progress. 

3 Task doing I/O at this device is being killed. 

4 Make this device available (unassigned) at the 
end of this I/O operation. 

5 Signals the task scheduler to reenter the DSR 
(at the next time slice). A DSR can use this flag 
to wait for a device by setting the flag and then 
returning to the system. 

6 End-of-record processing needs to be done for 
this PDT (data transfer is complete). 

7 = ASCII. 1 = JISCII. 
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Table 5-2. PDT Values (Continued) 



Hex. 
Byte 



Field 
Name 



Description 



>09 



>0A R3 PDTDTF 



DTFFIL 
DTFTIL 

DTFTIM 

DTFPRI 
DTFKSB 

DTFCOM 

DTFSYD 

DTFEXT 



Interrupt mask to be used by request entries to the DSR. This 
fieid is set during system generation or when the PDT is 
constructed. 

Device type flags that are all set at system generation time, 
except for the system disk flag that is set by the system 
loader: 

Bit Meaning When Set 

File-oriented device (if zero, the device is 
record oriented). 

1 The DSR accesses the data buffer directly. The 
calling task is not rolled out. The buffer must 
be accessed with LDD and LDS instructions. 
This bit is also called the TILINE I/O flag. 

2 The time-out logic should be enabled for this 
device. This flag can also be used by the DSR. 

3 Device can only be used by privileged tasks. 

4 This is a terminal (keyboard device) with a 
keyboard status block attached to the PDT. 

5 This is a standard communications device. 

6 This is the system disk. 

7 A PDT extension exists. This bit is always set 
when bit 4 is set. It is set when bit 4 is not set to 
indicate that a non-KSB extension is present. 
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Table 5-2. PDT Values (Continued) 



Hex. Field 

Byte Name Description 



Bit Meaning When Set 

8-11 Not used. 

12-15 Device type code, returned when the device is 
opened for I/O and returned for a Read Charac- 
teristics SVC. Device codes other than the 
ones in the following list might cause an error 
in some language packages (such as 
FORTRAN and COBOL). The number in 
parentheses after the device type name is the 
number of status bytes used when a log mes- 
sage is created. 

— Dummy (0) 

1 — Teleprinter (2) 

2 — Line Printer (2) 

3 — Cassette (2) 

4 — Card Reader (2) 

5 — Video Display Terminal (VDT) (4) 

6 — Disk (16) 

7 — Communications (4) 

8 — Magnetic Tape (1 6) 

E — AMPL Emulator (undefined) 
F — AMPL Trace Module (undefined) 

>0C R4 PDTDIB Pointer to the word after the PDT itself. This can be a disk 

PDT extension (DPD), tape PDT extension (TPD), line printer 
PDT extension (LPD), or your own extension, depending on 
the type of device. If a KSB is present, it must be the address 
oftheKSB. 

> 0E PDTR5 Scratch registers to be used by the DSR. 

through 
PDTR11 

>1C PDTCRU The CRU or TILINE address of the device. 

> 1E PDTR13 These three words contain the saved context (WP, PC, ST) to 

PDTR14 which the DSR returns control via a RTWP. 

PDTR15 

> 24 PDT$ Pointer to the beginning of the PDT workspace (byte 4 of the 

PDT). 

>26 PDTDSR A pointer to the first word of the DSR. 



5-16 946250-9705 



How to Write a Device Service Routine 



Table 5-2. PDT Values (Continued) 



Hex. 


Field 


Byte 


Name 


>28 


PDTERR 


>29 


PDTFLG 




DFGPRB 




DFGJAR 




DFGJAT 




DFGSTA 




DFGOPF 


>2A 


PDTNAM 


>2E 


PDTSL1, 




PDTSL2 



>32 

>34 



PDTBUF 
PDTBLN 



>36 
>38 



PDTINT 
PDTDVQ 



Description 



Error code returned by the DSR. 



Device flags as follows: 
Bit 
8 



Meaning When Set 



10 



Use the buffered I/O request block in log mes- 
sage. If not set, PDTSL1 and PDTSL2 are used. 

Receive mode for JISCII. Used by standard DSR 
to handle JlSCtl. 

Transmit mode for JISCII. Used by standard 
DSR to handle JISCII. 



11-12 Device state: online = 00, 
diagnostic = 10. Set by DX10. 



offline = 01, 



14 Operation failed bit. Set by the DSR to cause 

the system to indicate a failure in the system 
log. 

The 4-character device name. GEN990 renames devices said 
to have a KSB, STXX, where XX is the terminal ID. 

For CRU devices (indirect access), these words contain the 
controller image after an error. When you specify indirect 
access, the system log processor formats one or two words. 
For TILINE controllers (direct access), the first word contains 
the memory address of the controller image after an error. 
When you specify direct access, the system log processor 
goes to the address and formats the status bytes. The num- 
ber of status bytes depends on the type of device (refer to the 
list under bits 12 - 15 of PDTDTF). 

Not used. 

Maximum length of a data buffer that can be transferred by 
the device in an I/O operation (for example, 80 for a special 
device). This is only necessary for indirect buffer access 
(DTFTIL set to 0). The size of the data buffer times the num- 
ber of initiate I/O requests (maximum of 5) should be added to 
the response given to the I/O BUFFER prompt from GEN990. 

The reenter-me address for the DSR. 

The anchor for the queue of I/O requests for this device. 
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Table 5-2. PDT Values (Continued) 



Hex. 
Byte 



Field 
Name 



Description 



>42 



>44 



PDTTM1 
PDTTM2 



>46 



>48 



PDTSRB 



PDTFQL 



The number of system time units in the time-out count for the 
device. 

The number of time units remaining in the time-out count 
before the system assumes that a device error has occurred. 
The DSR signals the operating system to perform time-out 
processing by setting the time-out enable flag in PDTDTF to 
one. When the DSR starts an I/O operation and after every 
interrupt, the DSR should move the time-out count in 
PDTTM1 to this word (PDTTM2). The scheduler then uses this 
word as the time-out counter. Each time a system time unit 
has elapsed, the scheduler decrements the time-out count in 
this word. If the counter goes to zero, the system assumes 
that a device error has occurred and enters the DSR at the 
Abort I/O entry as indicated for the ABORT processing. 

The address of the queued SVC block plus two. This is a copy 
of R1 as it was at the I/O Call routine entry to the DSR. See 
paragraphs 5.3.1 and 5.7.3. 

DSR priority schedule queue word. 



Figure 5-6 shows a template for the PDT. You can probably tailor one of the PDTs in 
.S$SYSGEN.< sysname> .D$SOURCE to suit your device. After you write your PDT (in 990 
assembly language), you must include it in the system. To do this, you give the pathname of its 
source file in response to the PDT FILE prompt issued by GEN990. Refer to paragraph 3.4.5.10. 
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****************** 


*******^ 


t***ii 


******************************** 


* PHYSICAL 


DEVICE 


TABLE 




(PDT) 05/20/80 


************************************************************* 




DORG 











PDTLNK 


BSS 


2 




FORWARD LINKAGE TO NEXT PDT 


* THERE IS AN EXPANSION BLOCK 


BEFORE THE NEXT PDT. 


* 


TO REFERENCE IT USE THE VALUE IN PDTLNK PLUS 


* 


ONE OF THE 


FOLLOWING OFFSETS. WHEN PDTLNK IS 


* 


ZERO 


(DS01) 


USE THE VALUE IN PDTLST (GLOBAL 


* 


VARIBLE IN 


ROOT) . 






PDTRED 


EQU 


-8 






NUMBER OF READS 


PDTWRT 


EQU 


-6 






NUMBER OF WRITES 


PDTOTH 


EQU 


-4 






NUMBER OF OTHERS 


PDTRTY 


EQU 


-2 






NUMBER OF RETRIES 


PDTLUN 

it 


EQU 


-1 






NUMBER OF LUNOS ASSIGNED 


PDTMAP 


BSS 


2 




POINTER TO DSR MAP FILE 


PDTRO 


BSS 


2 




RO 


- DSR SCRATCH 


PDTPRB 


DATA 


$-$ 




Rl 


- QUEUED PRB ADDRESS 


PDTDSF 


BSS 


2 




R2 


- DEVICE STATUS FLAGS 


DSFASG 


EQU 









ASSIGNED 


DSFBSY 


EQU 


1 






BUSY 


DSFINT 


EQU 


2 






KILL I/O IN PROGRESS 


DSFKLL 


EQU 


3 






KILL TASK IN PROGRESS 


DSFCLS 


EQU 


4 






CLOSE OUT 


DSFREN 


EQU 


5 






RE-ENTER-ME 


DSFEOR 


EQU 


6 






END- RECORD 


DSFJIS 


EQU 


7 






JISCII FLAG(KATAKANA) 


PDTDTF 


BSS 


2 




R3 


- DEVICE TYPE FLAGS 


DTFFIL 


EQU 









FILE ORIENTED 


DTFTIL 


EQU 


1 






TILINE DEVICE 


DTFTIM 


EQU 


2 






ENABLE TIME-OUT 


DTFPRI 


EQU 


3 






PRIVILEDGED DEVICE 


DTFKSB 


EQU 


4 






TERMINAL WITH A KSB 


DTFCOM 


EQU 


5 






COMM DEVICE 


DTFSYD 


EQU 


6 






SYSTEM DISC 


DTFEXT 


EQU 


7 






EXPANSION BLOCK PRESENT 


PDTDIB 


DATA 


PDTLNK+PDTSIZ 


R4 


- DEVICE INFO BLOCK ADDRESS 


PDTR5 


BSS 


2 




R5 


- DEVICE SERVICE ROUTINE SCRATCH 


PDTR6 


BSS 


2 




R6 


- DSR SCRATCH 


PDTR7 


BSS 


2 




R7 


- DSR SCRATCH 


PDTR8 


BSS 


2 




R8 


- DSR SCRATCH 


PDTR9 


BSS 


2 




R9 


- DSR SCRATCH 


PDTR10 


BSS 


2 




RIO 


- DSR SCRATCH 


PDTR11 


BSS 


2 




Rll 


- DSR SCRATCH 


PDTCRU 


BSS 


2 




R12 


- CRU OR TILINE ADDRESS 


PDTR13 


DATA 


$-$ 




R13 


- SAVED WP 


PDTR14 


DATA 


$-$ 




R14 


- SAVED PC 


PDTR15 


DATA 


$-$ 




R15 


- SAVED ST 


PDT$ 


DATA 


PDTRO 




PDTRO ADDRESS 


PDTDSR 


BSS 


2 




DSR 


ADDRESS 


PDTERR 


BSS 


1 




SAVED ERROR CODE 


PDTFLG 


BSS 


1 




DEVICE FLAGS 



Figure 5-6. PDT Template (Sheet 1 of 2) 
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DFGPRB EQU 8 
DFGJAR EQU 9 
DFGJAT EQU 10 
DFGSTA EQU 11 



DFGOPF 

PDTNAM 

PDTSL1 

PDTSL2 

PDTBUF 

PDTBLN 

PDTINT 

PDTDVQ 

PDTTMl 

PDTTM2 

PDTSRB 

PDTFQL 



EQU 14 

BSS . 4 

BSS 

BSS 

BSS 

BSS 



BSS 
BSS 
BSS 
BSS 
BSS 
BSS 



2 

2 

2 

2 

2 

10 

2 

2 

2 

2 



USE PRB IN LOG MESSAGE 
JISCII RECIEVE MODE FLAG 
JISCII TRANSMIT MODE FLAG 
DEVICE STATE (TWO BITS) 

ONLINE = , OFFLINE = 1 
DIAGNOSTIC = 2, UNDEFINED 
OPERATION FAILED 
DEVICE NAME 

RESERVED FOR SYSTEM LOG 
RESERVED FOR SYSTEM LOG 
CRU BUFFER ADDRESS 
CRU BUFFER LENGTH 
DSR INTERRUPT ADDRESS 
DEVICE QUEUE ANCHOR 
TIME OUT COUNT 1 
TIME OUT COUNT 2 
SAVED PRB ADDRESS 
FAST REENTER ME QUEUE LINK 



= 3 



PDTSIZ EQU $ 
RORG 
PAGE 



Figure 5-6. PDT Template (Sheet 2 of 2) 

5.3.2 Keyboard Status Block (KSB) 

The KSB is appended to the PDT for keyboard devices. It provides additional data about the device 
TJirTr* a S f 7 ° n H works P ace - The K SB workspace is used to service* terrupf tor keyboard 
contains 6 StmCtUr6 ° f th6 KSB * nd Tab,e 5 ' 3 describes the 'nfornK tt 

nmviH-tJcSS^ 6 a ^ ^ ^V new ke y board devjce that uses SCI. You might find it useful to 

ZZ In ^ ? T deVlC6S that d ° n0t USe SCL Like the PDT > y° u must def « n * ^11 of the fields, 
even though the system provides some of the initial values. 
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HEX 
BYTE 



> 00 

> 02 

> 04 



> 08 



> 10 

> 12 

> 14 

> 16 

> 18 

i 

> 1A 

> 1C 

> IE 

> 20 

> 22 

> 24 

> 26 

> 28 

> 2A 

> 2C 

2283070 



R0 



R1 



R2 



> 06 R3 



R4 



> OA R5 



> OC R6 



> OE R7 



R8 

R9 
RIO 
R1 1 

R12 

R13 
R14 
R15 



KSBLDT STATION LOT ADDRESS 



KS8QOC — QUEUE LENGTH 



KSBQIP QUEUE INPUT POINTER 



KSBQOP QUEUE OUTPUT POINTER 



KSBQEP — QUEUE END POINTER 



RESERVED 



KSBFL — KSB FLAG 



KSBSN STATION NUMBER 



KSBR7 SCRATCH 



KSBTSB — TSB ADDRESS/VALIDATION TABLE ADDRESS 



KSBR9 — SCRATCH 



KSBCRU CRU BASE 



KSBR13 SAVED WP 

KSBR14 SAVED PC 

KSBR15 SAVED ST 



KSBLDO — PDT ADDRESS 



KSBLD2 LUNO 



KSBLD3 START I/O COUNT 



KSBLD4 LOT FLAGS 



KSBLD6 — LDT LINK 



KSBLD8 TSB ADDRESS 



KSBLCK LOCK COUNT 



Figure 5-7. KSB Structure 
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Table 5-3. KSB Values 



Hex. 
Byte 



Field 
Name 



Description 



>00 


KSBLDT 


>02 


KSBQOC 


>04 


KSBQIP 


>06 


KSBQOP 



>08 

>0A 
>0C 



>0D 
>0E 
>10 

>12 



KSBQEP 

RESERVED 
KSBFL 

KSBCHM 
KSBCIE 

KSBRCM 

KSBCIB 

KSBICP 

KSBSET 

KSBKIO 

KSBSN 

KSBR7 

KSBTSB 



KSBR9, 

KSBR10, 

KSBR11 



Scratch. 

The number of characters currently in the input character 
queue. Initialize to zero. 

A pointer to the next byte of the character queue that is avail- 
able to receive an input character (KSBBUF). 

A pointer to the oldest character in the input character 
queue, that is, the next character to be picked up by the DSR 
(KSBBUF). 

A pointer to the word after the character queue. That word 
contains the length of the queue (KSBBUF + KSBSIZ). 



Flags as follows: 
Bit 





Meaning When Set 

Character mode (no mapping). 



1 Allow the command interpreter to be used on 
this terminal. 

2 Keyboard is in record mode (always set). 

3 Bid task. Log-on request pending. 

4 The command interpreter is active. 

5 Hold I/O. 

6 Abort I/O. 
Station (terminal) ID. 

Scratch register for use by the DSR. 

The address of the TSB of the task currently using the ter- 
minal if the terminal is in character mode. If a validation table 
is being used, this field contains the validation table address. 

Scratch registers for use by the DSR. 
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Table 5-3. KSB Values (Continued) 



Hex. 
Byte 


Field 
Name 


>18 
>1A 


KSBCRU 
KSBR13 



Description 



The CRU or TILINE address of the terminal. 

The saved context (WP, PC, ST) to which the DSR keyboard 
interrupt handling routine returns control via an RTWP 
instruction. 



>20 



KSBLDO These 10 bytes form a logical device table (see the DX10 

Design Document) that serves as an anchor for the terminal 
local LDT list. Flag bit in byte > 24 is set to mark this LDT as 
an anchor. This LDT assigns terminal local LUNO to the 
terminal itself. 



>2A 



KSBLCK The lock out count, which is a count of the number of Read 

with Event Characters SVCs issued for this terminal. 



>2C 



KSBBUF The input character buffer. Its size is defined by the response 

to the CHARACTER QUEUE prompt from GEN990. This buffer 
must hold an even number of bytes (at least two). Typical 
buffers have six to ten bytes. This queue is used to store 
unsolicited characters from the terminal. 

KSBSIZ The length of the input character buffer. Must be an even 

number. 



>2E 



Figure 5-8 shows a template for the KSB. You might find it convenient to copy the source from 
one of the KSBs in .S$SYSGEN.<sysname>.D$SOURCE and tailor it to your device. You must 
append your KSB source to the PDT source, and place the address of the start of the KSB in R4 of 
the PDT. The device extension must follow the KSB. 
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********************************************************** 



* KEYBOARD STATUS BLOCK 
************************* 



(KSB) 
********************************* 





DORG 









KSBLDT 


DATA 


KSBLDO 


RO 


- STATION LDT ADDRESS 


KSBQOC 


BSS 


2 


Rl 


- QUEUE OUTPUT COUNT 


KSBQIP 


BSS 


2 


R2 


- QUEUE INPUT POINTER 


KSBQOP 


BSS 


2 


R3 


- QUEUE OUTPUT POINTER 


KSBQEP 


BSS 


2 


R4 


- QUEUE END POINTER 


KSBEBF 


DATA 





R5 


- EVENT CHARACTER BUFFER 


KSBFL 


BSS 


1 


R6 


- KSB FLAGS 


KSBCHM 


EQU 







CHARACTER MODE 


KSBCIE 


EQU 


1 




COMMAND INTERP ENABLE 


KSBRCM 


EQU 


2 




RECORD MODE 


KSBCIB 


EQU 


3 




COMMAND INTERP BID 


KSBICP 


EQU 


4 




COMMAND INTERP ACTIVE 


KSBSET 


EQU 


5 




COMMAND I/O HOLD 


KSBKIO 


EQU 


6 




COMMAND I/O ABORT 


KSBBRK 


EQU 


7 




DEACTIVATE BREAK KEY 


KSBSN 


BSS 


1 




- STATION NUMBER 


KSBR7 


BSS 


2 


R7 


- SCRATCH 


KSBTSB 


DATA 


$-$ 


R8 


- TSB ADDRESS 


KSBVTA 


EQU 


KSBTSB 




VALIDATION TABLE ADDRESS 


KSBR9 


BSS 


2 


R9 


- SCRATCH 


KSBR10 


BSS 


2 


RIO 


- SCRATCH 


KSBR11 


BSS 


2 


Rll 


- SCRATCH 


KSBCRU 


BSS 


2 


R12 


- CRU BASE 


KSBR13 


DATA 


$-$ 


R13 


- SAVED WP 


KSBR14 


DATA 


$-$ 


R14 


- SAVED PC 


KSBR15 


DATA 


$-$ 


R15 


- SAVED ST 


KSBLDO 


DATA 







PDT ADDRESS (PDTLNK) 


KSBLD2 


BYTE 







LUNO 


KSBLD3 


BYTE 







INIT I/O COUNT 


KSBLD4 


BSS 


2 




LDT FLAGS 


KSBLD6 


BSS 


2 




LDT LINK 


KSBLD8 


DATA 


$-$ 




TSB ADDRESS 


KSBLCK 


DATA 







LOCK COUNT 


KSBSIZ 


EQU 

RORG 

PAGE 


5-KSBLDT 







Figure 5*8. KSB Template 
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5.3.3 Buffered I/O Request Block 

The buffered I/O request block is the portion of the SVC block that contains information for the 
DSR. Figure 5-9 shows the structure and contents of the buffered I/O request block. DSRPRB is a 
template defined in .S$SYSGEN.SYSTEM.TABLES. The DSR uses this template to reference ele- 
ments of this data structure. Note that R1 contains the address of the I/O subopcode byte of the 
buffered I/O request block. Therefore, use offsets in your DSR as given in Figure 5-9, which are 
those defined by the DSRPRB template. 

The buffered I/O request block is copied to the system table area by DXIOS. The DSR must not use 
LDS or LDD to access parts of the buffered I/O request block. When the DSR completes, DXIOS 
copies the buffered I/O request block back to the user task. 

5.3.4 Task Status Block (TSB) 

Tasks are represented within DX10 by a TSB. The bidding routines TMBIDO and TM$BID build 
TSBs in the system table area. The termination task, TM$DGN, releases a TSB when a task termi- 
nates, unless the task is a queue server. TSBs of inactive queue servers are not released unless 
more system table area is needed. Figure 5-10 shows the format of a TSB, and Table 5-4 
describes the information it contains. 



DSRPRB < 



BYTE 
IN DSR 

-to 



-8 
-6 
-4 
-2 



2 



BROBRO QUEUE LINK 



BROTSB — REQUESTOR TSB ADDRESS 



BRORCB REQUESTOR CALL BLOCK ADDRESS 



BROLDT — LDT ADDRESS FOR WHICH CALL WAS MADE 



PRBSOC SVC OPCODE 



PRBOC SUBOPCODE 



PRBSFL — SYSTEM FLAGS 



PRBEC — STATUS CODE 



PRBLUN — LUNO 



PRBUFL — USER FLAGS 



PRBOBA — DATA BUFFER ADDRESS 



PRBRLN LENGTH OF DATA BUFFER 



PRBCHT CHARACTER COUNT 



2284689 



Figure 5-9. Buffered I/O Request Block 
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HEX. BYTE 



TSBQL — QUEUEING LINK 



TSBWP — ACTIVE WP 



TSBPC — ACTIVE PC 



TSBST — ACTIVE ST 



TSSPRI ~ PRIORITY 



TS8STA — TASK STATE 



TSBFLG — TASK FLAGS 



TSBEAC — TRANSFER VECTOR ADDRESS 



TSSID — INSTALLED 10 



TSBRID — RUN ID 



TSBSMF — SAVED MAP FILE AODRESS 



TSBLNK — FIXED TSB LINK 



TSBKSB — KSB AODRESS 



TSBFL2 — TASK FLAGS (WD2) 



TSBAR1 — BID PARAMETER (I) 



TSSAR2 — BIO PARAMETER (2) 



TSBALT — ALTERNATE TSB ADDRESS 



TSBCHR — 913.911 CHARACTER 



TSSIOC — TILINE I/O COUNT 



TSBPRI — PSB AODRESS (PROCEDURE I) 



TSBPR2 — PSB ADDRESS (PROCEDURE 2) 



TSBFCB — PROGRAM FILE FCB ADDRESS 



TBBERC — OIA GNOSTIC ERROR CODE 



TSBWPO — DIAGNOSTIC WP 



>2A 
>2C 
>2E 

>32 

>34 



TSBPCD — DIAGNOSTIC PC 



TSBSTD — DIAGNOSTIC ST 



TSBTOt — TIME DELAY COUNTER 
TSBTOZ 



TSBMLI — MAP LIMIT 1 



TSBMBI — MAP BIAS I 



TSBML2 — MAP LIMIT 2 



TSBMB2 — MAP BIAS 2 



TSBML3 — MAP LIMIT 3 



TSBMS3 — MAP BIAS 3 



>3E 

>40 
>42 
>44 



TSBPRF — FIXED PRIORITY 



TSBMRG — TASK REGISTER NUMBER 



TSBPAR — PARENT TSB AODRESS 



TSBSON — OLDEST SON TSB AODRESS 



TSBBRI — OLDER SIBLING TSB ADDRESS 



TSBBRZ — YOUNGER SIBLING TSB AODRESS 



TSBBLN — BEET LENGTH OF PROGRAM 



TSBTON — OVERLAY NUMBER 



TSBOAD — AODRESS OF OVERLAY AREA DESTINATION 



T3ST0 — TIME TASK SUSPENDED 



TSBTI — NUMBER OF TIME SLICES REMAINING 



>54 



TS8SCR — SCRATCH FOR GETMEM 



TSBRLL — LINK TO NEXT ROLLED TASK 



TSBRRN — ROLL FILE STARTING PHYSICAL RECORD NUMBER 



TSBRRL — NUMBER OF ROLL FILE RECORDS 



TSBLOF — LOCAL LOT LIST FLAGS 



TSBLDA — LOCAL LDT LIST ADDRESS 



TSBEOR — EOR COUNT 



TSBSER — QUEUE ANCHOR ADDRESS 



TSBTSC — TASK SENTRY COUNT 



Figure 5-10. TSB Structure 
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Table 5-4. TSB Values 



Hex. 
Byte 



Field 
Name 



Description 



>00 
>02 

>08 

>09 
>0A 



>0C 
>0E 
>0F 
>10 

>12 



TSBQL 

TSBWP, 
TSBPC, 
TSBST 

TSBPRI 



TSBST A 
TSBFLG 



TSBEAC 
TSBIID 
TSBRID 
TSBSMF 

TSBLNK 



>14 



TSBKSB 



Link to the next TSB on the queue, when this TSB is queued. 

The saved context (WP, PC, and ST values) for the task. When 
the task is scheduled to execute, these saved values are 
used to begin execution. 

Task priority (0, 1, 2, 3, or > 81, > 82, > 83, ..., > FF, where > 81 
is real-time priority 1 and > FF is real-time priority 127). 

Task state as shown in Table 5-5. 

First word of task flags. The flags are as follows: 

Bit Meaning When Set 

System task (hardware and software privilege) 

1 Privileged task (software) 

2 Memory-resident task 

3 Take end action on error 

4 Roll out candidate 

5 Rolled out 

6 Abort/terminate task 

7 Activate call outstanding 

8 Reactivate bidding task at termination 

9 Serially reusable task 

10 Task quieting in progress 

11 Initial bid 

1 2 Leave task alone; do not abort 

13 Task is under control of alternate TSB 

14 SCI flag for scanning TSB chain 

15 Task is replicated image 

Transfer vector address. 

Installed task ID. 

Runtime ID assigned by system. 

Address in the TSB of the saved map file register values 
(bytes > 32 - > 3D). 

Link to the next TSB in the fixed list of TSBs. All TSBs in the 
system table area are linked onto this list when they are cre- 
ated. The list can be searched to find a task with a given run- 
time ID by the routine named TMTSCH (for example, to kill 
the task). 

Address of the KSB of the terminal associated with this task 
(that is, the task was bid from the terminal). 
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Table 5-4. TSB Values (Continued) 



Hex. 
Byte 



Field 
Name 



Description 



>16 



TSBFL2 



Task flags as follows: 



>18 



>1C 



TSBAR1 



TSBALT 



>1E 


TSBCHR 


>1F 


TSBIOC 


>20 


TSBPR1 


>22 


TSBPR2 


>24 


TSBFCB 



>26 



>28 



>2E 



TSBERC 



TSBWPD, 
TSBPCD, 
TSBSTD 



TSBTD1 



Bit 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13-15 



Meaning When Set 



Task to be suspended next time it executes 

Task is being controlled 

SVC traps to be taken when specified 

SVC switch: when 0, SVC traps are taken 

Execution stopped by scheduler 

Execution stopped by trapped SVC 

Execution stopped by XOP 15,15 (breakpoint) 

Dynamic priority management 

Roll in progress 

Task activated 

Initiate followed by execute I/O 

Extend time slice 

End action available for task 

Not used 



The two parameters that can be passed to the task by the 
Bid SVC and accessed by the task using the Get Bid 
Parameters SVC. 

TSB address of the alternate task. The alternate task is 
executed in place of this task. 

913/911 character. 

Number of outstanding TILINE I/O operations. 

Address of the procedure status block for attached pro- 
cedure 1 (0 if none). 

PSB address for procedure 2 (0 if none). 

Address of the FCB that represents the program file on 
which this task is installed. 

Error code that describes the error that caused the task 
to terminate (used by the termination task). 

The context (WP, PC, and ST registers) of the task when 
an error forced the task to terminate or take end action 
(used by the termination task). A Get End Action Status 
SVC returns these values. 

Number of system time units remaining before this task 
will be reactivated from its time-delayed state (32 bits). 
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Table 5-4. TSB Values (Continued) 



Hex. 
Byte 



Field 
Name 



Description 



>32 



TSBML1 



>3E 


TSBPRF 


>3F 


TSBMRG 


>40 


TSBPAR 


>42 


TSBSON 


>44 


TSBBR1 


>46 


TSBBR2 


>48 


TSBBLN 


>4A 


TSBTON 


>4C 


TSBOAD 



>4E 


TSBTO 


>50 


TSBT1 


>52 


TSBSCR 


>54 


TSBRLL 



The map register values to be used when this task 
executes. 

Map flags. Fixed priority of task. 

The offset into the saved map file that marks the limit 
register that maps the task segment (that is, 0, 4, or 8). 

TSB family tree pointers. 

TSB family tree pointers. 

TSB family tree pointers. 

TSB family tree pointers. 

Length of the entire program (task and procedures) in 
beets (32-byte blocks). 

The number of the system overlay in which this task was 
last executing (used for system tasks only). 

The address of the overlay area in which the above over- 
lay was loaded (the overlay MUST be reloaded in the 
same place). 

Number of time slices this task has been suspended. 

Number of time slices still allotted to this task as the 
minimum number of time slices it must receive before it 
can be forcibly rolled-out by an equal priority task. 

Scratch used by the Get Memory SVC processor and the 
system overlay loader. 

Link to the TSB or PSB that represents the next rolled 
segment. The TSB or PSB of each roiled task or proce- 
dure is linked onto a list of rolled segments. The list is 
kept in order by increasing the roil file record number; 
that is, segments written at the beginning of the roll file 
appear at the beginning of the list. This linked list serves 
as a directory into the roll file, so that the various rolled 
segments can be retrieved for roll-in. Further roll informa- 
tion is kept in TSBs or PSBs. 
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Hex. 
Byte 



Table 5-4. TSB Values (Continued) 



Field 
Name 



Description 



>56 

>5A 

>5C 
>5E 

>60 



TSBRRN 

TSBRRL 

TSBLDF 
TSBLDA 

TSBEOR 



>61 


TSBIIP 


>62 


TSBSER 


>64 


TSBTSC 


>66 


* 



Number of the physical record in the roll file that begins 
the rolled image of the task segment. At initial bid time, 
this is the program file record number. 

Number of roll file records occupied by the rolled task 
image. During initial bid, this is the length of the task in 
bytes. 

Task local LDT list flags: bit is the LDT anchor. 

Pointer to the first task local LDT, or the station local 
LDT list anchor (if no task local LDTs exist). 

Number of I/O end-of-records that need to be processed 
for this task. If this field is nonzero, the device driver rou- 
tine (DDT) receives the next time slice that would other- 
wise have been awarded to this task. 

The number of I/O operations outstanding for this task. 

The address of the anchor for the queue served by this 
task (used only for queue servers). 

The task sentry count. 
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Table 5-5. Task State Codes 



Task 

State Significance 



00 Active task, priority level 

01 Active task, priority level 1 

02 Active task, priority level 2 

03 Active task, priority level 3 

04 Terminated task 

05 Task in time delay 

06 Suspended task 

07 Currently executing task 

08 Reserved 

09 Task awaiting completion of I/O 

0A Task awaiting assignment of device for I/O 

0B Task awaiting disk file utility services 

0C Reserved 

0D Task awaiting file management services 

0E Task awaiting overlay loader services 

OF Task awaiting initial load 

10 Reserved 

10 Task awaiting disk management services 

12 Task awaiting tape management services 

13 Waiting on system overlay loader services 

14 Waiting on task driven SVC processor 

15 Task waiting on GETMEM request 

16 Not used 

1 7 Suspended for co-routine activation 

18 Task waiting on termination task services 

19 Task awaiting completion of any I/O 
1A Waiting on MM$FND door 

1 B Task eligible for rollout when requested I/O is complete 

1C Task activated while roll in progress 

1 D Suspended for initiate I/O threshold 

1 E Suspended for locked directory 

1 F Suspended for task management directory buffer 

24 Task suspended for queue input 

FF Dummy task state 
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5.3.5 Extension for Terminals with Keyboards (XTK) 

The XTK is an extension used by Tl DSRs for terminals. It functions as an extension to the KSB. 
Figure 5-1 1 shows the structure of the XTK, and Table 5-6 describes the values it contains. Figure 
5-12 shows the template for the XTK. 



HEX. 
BYTE 



>00 
>02 
>04 

>06 
>08 
>0A 
>OC 
>0E 
>10 



>!2 

>14 * 

2284696 



XTKXUF EXTENDED USER FLAGS 



XTKFLG — GENERAL. FLAGS 



XTKSCH SAVED CHARACTER 



XTKCRD — CARRIAGE RETURN DELAY COUNT 



XTKICD INTERCHARACTER DELAY COUNT 



XTKABT — CODE ADDRESS TO PERFORM ABORT 



XTKTMO --.TIMEOUT COUNT FOR HANG CONDITION 



XTKSC3 — SCRATCH 



XTKSSC — SAVED STATUS OF CASSETTES 



EDTFLO — EXTENDED EDIT FLAG WORD 



EDTFL1 — EXTENDED EDIT FLAG WORD 1 



Figure 5-11. XTK Structure 
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Table 5-6. XTK Values 



Hex. 
Byte 



>00 
>02 



>03 
>04 
>06 
>08 
>0A 
>0C 
>0E 
>10 



Field 
Name 



Description 



XTKXUF Extended user flags from BRB 

XTKFLG General flags: 

Bit Meaning When Set 

KSFHNG — Hang-up condition on 745 

1 KSFTMS — Time-out switch for 745 

2 KSFSCI — SCI active during hang up 

3 KSFDCD — Data carrier drop detected 

4 KSFSIO — Shift in/shift out JISCII 

5 KSFDIF — Direct character input requested 

XTKSCH Saved character for JISCII terminals 

XTKCRD Carriage return delay count 

XTKICD Intercharacter delay count 

XTKABT Code address to perform abort 

XTKTMO Time-out count for hang condition 

XTKSC3 Scratch 

XTKSSC Saved status of cassettes 

EDTFLO Edit flag word 1 

Bit Meaning When Set 

0-7 Reserved 

8 MDTCHK — Post data modified on read 

9 EXVAL — Extended character validation 

10 NULFLG — Null character 

11 CNBFLG — Covert null to blank 
12-15 Reserved 
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Table 5-6. XTK Values (Continued) 



Hex. 
Byte 



Field 
Name 



Description 



>12 



EDTFL1 Edit flag word 2 

Bit Meaning When Set 

0-1 Reserved 

2 LEFARO — Terminate read on left arrow 

3-11 Reserved 

12 RITSARO — Terminate read on right arrow 

13-15 Reserved 
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UNL 
************************************************************ 

* ' 

* EXTENSION FOR A TERMINAL (XTK) 02/12/82 

* WITH A KEYBOARD 



************************************************************ 

DORG XTKBGN 

XTKXUP WORD EXTENDED USER FLAGS FROM BRB 

XTKFLG FLAGS 8 XTK GENERAL FLAGS 

FLAG KSFHNG HANG UP CONDITION ON 74 5 

FLAG KSFTMS TIME OUT SWITCH FOR 745 

FLAG KSFSCI SCI ACTIVE DURING HANG UP 

FLAG KSFDCD DATA CARRIER DROP DETECTED 

FLAG KSFSIO SHIFT IN/SHIFT OUT JISCII 

FLAG KSFDIF DIRECT CHAR INPUT REQUESTED 

BYTE SAVED CHAR FOR JISCII TERMINAL 

EQU XTKFLG FILL CHARACTER 

EQU XTKFLG+1 EVENT CHARACTER 

WORD CARRIAGE RETURN DELAY COUNT 

EQU XTKCRD WITHIN FIELD CURSOR POSITION 

WORD INTER-CHARACTER DELAY COUNT 

EQU XTKICD START OF FIELD CURSOR POSITION 

EQU KSBVTA VALIDATION TABLE ADDRESS 

WORD CODE ADDRESS TO PERFORM ABORT 

EQU XTKABT SCRATCH # 1 

WORD TIMEOUT COUNT FOR HANG CONDTION 

EQU XTKTMO SCRATCH # 2 

WORD SCRATCH # 3 

WORD SAVED STATUS OF CASSETTES 

EQU XTKSSC ASCII/JISCII INTENSITY MASK 



XTKSCH 

XTKFIL 

XTKEVT 

XTKCRD 

XTKPOS 

XTKICD 

XTKDEF 

XTKVTA 

XTKABT 

XTKSC1 

XTKTMO 

XTKSC2 

XTKSC3 

XTKSSC 

XTKJIN 

* 

* 

* EDIT 
*___. 

EDTFLO 
* 

MDTCHK 

EXVAL 

NULFLG 

CNBFLG 

* 

* 

* — .__ _ 

* EDIT 
* 

EDTFL1 
* 

LEFARO 
* 

RITARO 



FLAG WORD AT END OF XTK 
WORD 



EQU 8 

EQU 9 

EQU 10 

EQU 11 



EXTENDED EDIT FLAG WORD 
NOTE: BITS 0-7 ARE USED ! 
POST DATA MODIFIED ON READ 
EXTENDED CHAR VAL 
NULL CHARACTER 
CONVERT NULL TO BLANK 
NOTE: BIT 12 IS USED 1 
NOTE: BITS 13-15 RESERVED 



FLAG WORD 1 AT END OF XTK 
WORD 
EQU 2 
EQU 12 



EXTENDED EDIT FLAG WORD 1 
NOTE: BITS 0-1 ARE USED ! 
1=TERMINATE RD ON LEFT ARROW 
NOTE: BITS 3-11 ARE USED ! 
1=TERMINATE RD ON RIGHT ARROW 
NOTE: BITS 13-15 ARE USED ! 



*CM* 

*CM* 

*CM* 
*CM* 
*CM* 
*CM* 



*CM* 
*CM* 
*CM* 
*CM* 



XTKSIZ 



EQU $ 
RORG 
PAGE 
LIST 



Figure 5-12. XTK Template 
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5.3.6 Asynchronous DSR Local PDT Extension 

The asynchronous DSR structure requires a PDT extension. Figure 5-13 shows the structure of 
this extension, and Figure 5-14 shows the template for this extension. The pathname for this tem- 
plate is .S$SYSGEN.SYSTEM.TABLES.DSALLLEX. 

This extension starts immediately after the KSB. The first two words of this extension are used to 
access a second DSR data structure (PDT extension) outside the local address space of the DSR. 
Paragraph 5.5.5 discusses the procedure for initializing these two words. The next five words, 
PDXFLG through PDXCP3, are reserved for HSR use. The remaining local PDT extension words are 
for TSR/ISR use. The size of this portion of the local PDT extension varies for different 
asynchronous devices. 



HEX BYTE 
>0 

>2 

>4 

>5 

>6 

>8 

>A 

>C 

>E 

>10 
>12 

2284697 



PDXSMB LONG DISTANCE EXTENSION MAP BIAS 



PDXSMP — LONG DISTANCE EXTENSION MAP POINTER 



PDXFLG — HSR PARAMETER BYTE 



PDXCHN — HSR PARAMETER BYTE 1 



PDXCP1 — HSR PARAMETER BYTES 2 AND 3 



PDXCP2 HSR PARAMETER BYTES 4 AND 5 



PDXCP3 HSR PARAMETER BYTES 6 AND 7 



PDXCP4 — TSR/ISR PARAMETER BYTES AND 1 



PDXCP5 - - TSR/ISR PARAMETER BYTES 2 AND 3 



PDXCP6 TSR/ISR PARAMETER BYTES 4 AND 5 



PDXCP7 - • TSR/ISR PARAMETER BYTES 6 AND 7 



Figure 5-13. Asynchronous DSR Local PDT Extension Structure 
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********************************************************** 

* * 

* LOCAL ASYNC EXTENSION TO PDT * 

* * 

********************************************************** 

DORG KSBSIZ 

PDXSMB BSS 2 LONG DIST EXT MAP BIAS 

PDXSMP BSS 2 LONG DIST EXT MAP POINTER 

PDXFLG BSS 1 HSR MEMORY AREA 

PDXCHN BSS 1 " 

PDXFCT BSS 2 " 

PDXCP1 BSS 2 w 

PDXCP2 BSS 2 

PDXCP3 BSS 2 n 

PDXCP4 BSS 2 



TSR MEMORY AREA 



RORG 



Figure 5-14. Asynchronous DSR Local PDT Extension Template 



5.3.7 Asynchronous DSR Long-Distance Device Extension 

The asynchronous DSRs use a long-distance extension for part of the PDT extension area. This 
memory must be accessed using long-distance instructions. The long-distance extension is 
divided into several areas. Figure 5-15 shows the structure of this extension, and Figure 5-16 
shows the template for this extension. The pathname for this template is 
.S$SYSGEN.SYSTEM.TABLES.DSALLREX. 

The first 32 bytes beginning with HSRBGN are reserved for HSR module use. The next 112 bytes 
provide memory for a software transmit FIFO maintained by the HSR for non-buffered controllers. 
The only buffered asynchronous controllers are the CI403 and the CI404. The remainder of the 
long-distance extension is for TSR/ISR use. Its size varies with the functions that the TSR and ISR 
modules perform. The example template defines areas for an implementation that keeps a mem- 
ory copy of the screen image for VDT support. Fourty-eight bytes are provided for TSR/ISR use. 
The TSR uses the memory starting at SIBUFF to maintain a memory image of the VDT screen. 
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HEX. BYTE 



>0 



>1 F 
>20 



>8F 
>90 



>BF 
>C0 



>83F 
2284698 



HSRBGN -- HSR PORTION OF EXTENSION 
(32 BYTES) 



SWFBGN -- SOFTWARE FIFO BEGIN 
(112 BYTES) 



TSRBGN-- TSR/ISR PORTION OF EXTENSION 
(4 8 BYTES) 



SI BUFF SCREEN IMAGE BUFFER 

(1920 BYTES) 



Figure 5-15. Asynchronous DSR Long-Distance Device Extension Structure 



********************************************************** 

*** ASYNC LONG DISTANCE EXTENSION *** 

********************************************************** 

DORG 

HSR PORTION OF DEVICE EXTENSION 
HSR DEPENDENT BLOCK 



HSRBGN EQU $ 

BSS >20 
HSREND EQU $ 



SWFBGN EQU HSREND 

BSS >70 

SWFEND EQU $ 

* 

TSRBGN EQU SWFEND 

BSS >30 

TSREND EQU $ 

* 

SIBUFF EQU TSREND 

BSS >780 

SI END EQU $ 

RORG 



SOFTWARE XMIT FIFO 



TSR PORTION OF DEVICE EXTENSION 



SCREEN IMAGE BUFFER 

1920 BYTE SCREEN IMAGE BUFFER 



Figure 5-16. Asynchronous DSR Long-Distance Device Extension Template 



5-38 



946250-9705 



How to Write a Device Service Routine 



5.4 DSR CONVENTIONS AND TECHNIQUES 

This paragraph describes some of the methods used in writing the standard DX10 DSRs. When 
you write your own DSR, you can use these conventions and techniques to simplify your task and 
to make your DSR easier to maintain. The example DSRs provided at the end of this section dem- 
onstrate many of these methods. 

5.4.1 Workspace for Keyboard ISRs 

When you write an ISR for a keyboard device, you need to buffer the input keystrokes. Common 
subroutines provided with the operating system can handle keyboard input only if you provide a 
KSB. Since these routines use the workspace in the KSB, your DSR interrupt decoder and proces- 
sor should also employ this workspace. 

5.4.2 Decoding Interrupts 

It is often necessary for a DSR to return to the system to wait for the next interrupt, and provide the 
address of a routine in the DSR which is coded to handle that interrupt. Since GEN990 allows only 
one interrupt entry point for an ISR, DX10 DSRs commonly use R6 in the interrupt processing 
workspace as an interrupt entry vector. When the DSR needs to wait for an interrupt, the DSR 
loads the address of an interrupt processor into R6 and executes an RTWP instruction. When the 
interrupt occurs, the ISR resets the time-out and branches to the address in R6. If you use a KSB, 
be sure to only transfer control from the ISR to the other DSR routines (that use the PDT work- 
space) by using a BLWP or the reenter-me mechanism. Use KSB R6 only for ISR entries and use 
PDT R6 only for entries to DSR routines that use the PDT workspace. 

5.4.3 Reporting Errors to the System Log 

Most DSRs report device errors to the system log by placing an appropriate error code in PDTERR 
of the PDT and setting the Operation Failed flag in PDTFLG. You can use the device controller 
address in R12 of the PDT workspace to obtain controller status information. Most CRU 
controllers have one word of status information. 

If the device buffer access method selected by the DTFTIL bit of PDTDTF is not direct (that is, the 
value of the DTFTIL bit is 0), you should store status information in the system log words (PDTSL1 
and PDTSL2) to report the error to the system log. If the buffer access method is direct (the value 
of the DTFTIL bit is 1), your PDT must have an area set aside for log data and PDTSL1 must con- 
tain the address of that area. Refer to the following paragraph for a discussion of buffer access 
methods. 
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5.4.4 Accessing the Data Buffer 

You can access the data buffer associated with the I/O SVC in two ways. You select the method 
when you code the PDT by setting the value of bit 1 of PDTDTF (DTFTIL) as follows: 

= Indirect access. DX10 DSRs use this method for CRU devices such as data terminals 

and line printers. It provides the flexibility for DX10 to roll out the calling task, and is 
suitable for devices (such as data terminals) that may have a relatively long response 
time under some conditions. The operating system makes a copy of the data buffer in 
system table area, and the DSR references that copy. 

1 = Direct access. DX10 DSRs use this method for TILINE devices such as disks and mag- 

netic tapes. The calling task cannot be rolled while I/O is in progress and is suitable for 
devices that have a relatively short response time under all conditions. The I/O 
scheduler does not make a copy of the data buffer, so this method is also suitable for 
devices with very long buffers. 

The use of direct and indirect access need not be limited to TILINE and CRU type of devices. DX10 
does not really care what the underlying device type is. You need to decide which access mode 
suits the needs of your device. Note that if you select direct access for a device that can have a 
long response time, the system can appear to lock up until the I/O completes. This symptom is 
caused by the following condition. Task A has an I/O request pending on a device for which direct 
access is specified, and the operating system does not have enough memory to roll in task B for 
execution. It flags task A so that it is rolled out when the I/O completes instead of being placed in 
execution. Task B is not loaded until then. You can relieve this condition by making the task that 
makes such an access a memory-resident task. 

5.4.4.1 Indirect Access. For buffers accessed indirectly, DX10 creates a copy of the data buffer 
in the system table area. It modifies the buffer address in the system's copy of the buffered I/O 
request block (pointed to by R1 in the PDT) to point to the system's copy of the buffer. The DSR 
should access this copy of the buffer. When the DSR calls ENDRCD (see paragraph 5.7.3), the sys- 
tem copies the buffered I/O request block and the buffer back to the task that issued the SVC. The 
system also takes care of all task rollin/roilout processing. 

5.4.4.2 Direct Access. For buffers accessed directly, DX10 makes a copy of only the buffered 
I/O request block. The buffer address in the buffered I/O request block is relative to the address 
space of the calling task. The DSR has its own map file, loaded into map file of the CPU. That 
map file brings together the system root, the I/O common routines, and the DSR all into one 
address space. The system root is the part of the operating system linked in phase 0. (Refer to the 
DX10 Design Document for a discussion of system memory mapping.) The calling task executes in 
CPU map file 1. The DSR must load CPU map file 2 using the LDD and LDS instructions with the 
same map file used to execute the task, and must use the buffer address in the next instruction. 
For additional details, refer to the 990/10 and 990/12 Assembly Language Reference Manual. 
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You can access the map file for the task by accessing its TSB. The address of the TSB is located in 
the buffered request overhead block, which immediately precedes the buffered I/O request block. 
The TSB has a pointer to the map file for the task at TSBSMF. The following code places the first 
word of the data buffer in R4: 

MOV @ PRBDBA(R1),R5 R5 < = ADDRESS OF TASK BUFFER 

MOV @ BROTSB(R1),R7 R7 < = ADDRESS OF TSB 

MOV @TSBSMF(R7),R7 R7< = ADDRESS OF MAP FILE 

LDS *R7 

MOV *R5,R4 R4< = FIRSTWORD OF BUFFER 

5.4.5 Reenter-Me Processing 

Some DSRs employ reenter-me processing to produce time delays or to allow an interrupt to bid a 
task. (For more information on bidding tasks from the DSR, refer to paragraph 5.4.7.) The reenter- 
me flag is DSFREN in PDTDSF in the PDT. You can use it in conjunction with the reenter-me 
address in PDTINT. When you set the reenter-me flag to one, the task scheduler sets the interrupt 
mask to the value in DSFINT in PDTDSF, resets the reenter-me flag to zero, and transfers control 
to the reenter-me address specified in PDTINT of the PDT. 

In DX10, VDT DSRs use this flag to transfer control from the keyboard ISR (which runs with inter- 
rupts masked in the KSB workspace) to the I/O Call routine (which runs with interrupts unmasked 
in the PDT workspace). Whether your DSR uses this flag depends on the needs of your device. 
Keyboard devices such as the 911 VDT need to handle characters typed when a Read I/O is not 
active (unsolicited input). When the user enters data without a read operation pending, DSR911 
queues the characters in the KSB, placing them in a Read I/O SVC data buffer only after it receives 
the SVC. Since DSR911 runs in the PDT workspace with ail interrupts enabled, it needs to keep 
interrupt processing separate from call block processing to avoid interference between the DSR 
and ISR. Such interference is still possible between the PUTCBF and GETC routines, so the DSR 
inhibits interrupts for the duration of PUTCBF and GETC calls. When a character is received, and a 
Read I/O SVC is active, the ISR uses reenter-me because it cannot directly call the DSR. A DSR 
that runs with interrupts inhibited to a level that prevents concurrent execution of the ISR does not 
need to use the reenter-me flag. It can call the DSR (using BLWP) directly from the ISR. This allows 
a device to have a KSB without the extra coding necessary for reenter-me processing. The KSB 
and reenter-me flag provide the flexibility needed to handle these situations. 

5.4.6 DSR Priority Schedule 

This procedure allows you to activate the DSR faster than the reenter-me processing. The operat- 
ing system enters the DSR before any task executes. All operating system functions complete 
before the DSR is activated. PDTs are placed on a queue for processing. The routines that manage 
the queue make sure a PDT is only on the queue once. Byte 8 must contain a Branch instruction to 
the routine to process this entry. 

To place an entry on the queue, put the starting address of the PDT in RO of whichever workspace 
is in use. Use a BLWP instruction to branch to the routine TM$FST. The code to place the current 
PDT address on the DSR priority schedule queue is as follows: 

MOV R4,R0 
AIRO,PDTLNK 
BLWP @TM$FST 

This code assumes the use of the template DSRPDT, which is offset by R4. 

946250-9705 5 " 41 



How to Write a Device Service Routine 



DX10 Release 3.6 changed the DX10 scheduler to implement DSR priority scheduling. The 
scheduler now returns to any map file code before checking for queued PDTs or for a task. There- 
fore, if the DSR priority schedule routine in the DSR is interrupted, control immediately returns to 
the DSR. 

When the PDT is selected from the queue, the interrupt mask level is set to the value contained in 
PDTDTF in the PDT. This value should be > F to allow interrupts to occur in a normal manner. 

5.4.7 Bidding Tasks from a DSR 

You can execute a task as a result of an interrupt by bidding it from within a DSR. The bid takes 
place in the ISR and reenter-me processor. In the ISR, you set the flags for bidding the task. In the 
reenter-me routine, you call the subroutine TMBIDO, which bids the task. (You must bid the task 
within the reenter-me routine to ensure that no executing task has extended the time slice.) 

The task must be installed on the system program file. If you want fast execution, install it mem- 
ory resident with an appropriate real-time priority. 

5.4.7.1 ISR Procedure for Bidding a Task. The ISR must do the following preprocessing in 
response to an interrupt to bid a task: 

1 . Reset the interrupt from the device that caused the ISR to be entered. 

2. Check your bid task in progress flag. If a bid task is in progress, ignore this request to 
bid a task. 

3. Set your bid task in progress flag. 

4. Provide a way to handle multiple interrupts received before the first bid is complete. 
Typically, you ignore subsequent bid requests until the one in progress is complete by 
checking the flag set in step 2. 

5. Set the reenter-me flag in the PDT (bit DSFREN in word PDTDSF of the PDT). 

6. Increment the value of BIDTSK by one. The scheduler uses this word to check if any bid 
requests are pending. 

7. Check the global flag TMESLC. If zero, then set the global flag TM$DFR to - 1. TMESLC 
indicates whether a system task has inhibited scheduling and TM$DFR forces the 
scheduler to execute as soon as scheduling is enabled. The following code performs 
this test: 

MOV@TMESLC,R0 
JNECONT 
SETO ©TM$DFR 
CONT < next instruction> 

8. Exit using an RTWP instruction. 
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5.4.7.2 Reenter-Me Procedure for Bidding a Task. The reenter-me routine must do the following 
processing to bid a task: 

1 . Initialize the workspace registers as follows: 

R1 Installed ID of the task in the first (upper) byte; second (lower) byte set to 

zero. 

R2 Bid parameters. 

R3 Bid parameter #2. 

R4 Station ID for the task in the first (upper) byte (> FF if no station); second 

(lower) byte set to zero. 

R10 Pointer to a block of memory that the DX10 routines that are used for 

bidding a task can use for a stack. Provide at least 15 words. 

R1 1 Used by subroutine linkage. 

2. Use the BL instruction to call the common routine TMBIDO. TMBIDO places the task on 
the active queue. Reference the symbol TMBIDO at the beginning of the DSR. 

3. Reset your bid task in progress flag. 

4. Decrement the value BIDTSK. 

5. Check the error returned by TMBIDO and take the appropriate action. You may ignore the 
bid request, bid an alternate task, or write a message to the terminal. TMBIDO returns 
the following information: 

RO Error code: 

— No error. 

1 — Invalid station number specified. 

2 — No runtime task ID available. 

3 — No system table area available. 

4 — Invalid program file LUNO. 

R1 Run time ID in first byte; bit 15 indicates whether the request has been 

queued: 

— Request not queued; task was memory resident. 

1 _ Request queued; task was disk resident and must be loaded. 
R2 TSB address of bid task. 
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5.5 ASYNCHRONOUS DSR STRUCTURE 

This paragraph describes the DSR structure for asynchronous device support. Throughout this 
paragraph, the term DSR refers to an asynchronous DSR. Table 5-7 shows the device and con- 
troller combinations that the asynchronous DSRs provided by Tl support. 



Table 5*7. Asynchronous Device Support 



Controllers 



931 



940 



Devices 

Business 
System 
Terminal 810 



840 



85X 



CI401 Y Y Y 

CI402 Y Y Y Y Y 

CI421 Y Y Y 1 Y 1 

CI422 Y Y Y Y 

/10A* Y Y Y Y Y 

CI403 Y Y Y Y Y 

CI404 Y Y 3 Y 3 Y 3 Y 3 

931 4 Y Y 

940 4 Y Y Y 

Business 

System Y Y Y 

Terminal 4 

Notes: 

1 On the CI421 controller, printers are supported only on the 9902 port. 

2 /10A refers to the TMS9902 communications port on the 990/10A processor printed circuit board. 

3 These devices connect to the CI404 via the fiber optics to EIA RS-232C converter module. 

4 In the controller column, 931, 940, and Business System terminal refer to the auxiliary (AUX1) port 
of the VDT. 
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The asynchronous DSR design separates controller and device support into different software 
modules. Figure 5-17 displays a block diagram of the DSR structure. The DSR consists of three 
basic modules. The hardware controller service routine (HSR) module provides the controller sup- 
port and is supplied by Tl. The terminal service routine (TSR) module provides device support. The 
interrupt service routine (ISR) module has interrupt and high priority processing responsibility. 
You can include the TSR and ISR in the same source file if you want. The following list describes 
the basic functions of the DSR components: 

TSR 

— All DSR entry points except interrupt entry (I/O Call, Power Restored, Abort, DSR 
priority schedule, and reenter-me) 

— Request and completion reporting interface to DX10 

— Runs in PDT workspace 

— Provides software interface to device 

— Contains device-dependent logic 
ISR 

— Contains interrupt entry of the DSR 

— Interface to HSR for interrupt processing 

— High priority receive character processing 

— Runs in DSR interrupt workspace (not the PDT workspace) 
HSR 

— Generic (subroutine) software interface to the controller hardware 

— Contains all controller dependent logic 

— Contains all direct access to controller 

— Presents a buffered controller interface to other DSR modules 
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2284699 



OPERATING SYSTEM 
▲ 



TSR TERMINAL 
SERVICE ROUTINE 



B!_ 



TSR 
SCHEDULE 



1SR INTERRUPT 
SERVICE ROUTINE 



BL 



HSR CONTROLLER 
SERVICE ROUTINE 



CONTROLLER 
INTERRUPT 



CONTROLLER 



Figure 5-17. Asynchronous DSR Structure 
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The asynchronous DSR design can support several device and controller combinations. HSR 
object modules are provided with the operating system for the controllers listed in Table 5-8. 
Table 5-8 also documents the final node in the pathname for each HSR. The directory that con- 
tains the HSR object modules is < vol> .S$SYSGEN, where < vol> is the volume name of the disk 
you specify as the data disk. 

Table 5-8. HSR Object Modules 



Name Controller Type 



DS403HSR CI403/CI404 

DS923HSR TMS 9902 and 9903 controllers * 

DS401 HSR CI401 (previously COMM l/F) 

Note: 

* Includes CI402, CI422, CI421, the 990/10A 9902 port, and the 9902 interface 
associated with the internal terminal on the Business System 300 computer. 



These HSR modules are available for users implementing DSRs for special devices connected to 
these controllers. These modules are used for DSRs following the asynchronous DSR design. This 
design must be followed for user-written DSRs if both of the following conditions are true: 

• The special device is connected to a CI403 or CI404 controller. 

• A standard Tl DSR supports any of the communication channels of the C1403 or CI404. 

When both of these conditions are not true, you have a choice of DSR designs for asynchronous 
device support. You can implement either the asynchronous DSR design or a design of your 
choice. Remember that any user design must obey all DX10 constraints. 

5.5.1 Asynchronous DSR Design Overview 

Figure 5-18 displays a detailed DSRflow diagram. This figure displays data flow paths as well as 
the DSR logic flow. Refer to Figure 5-18 during the following discussion of the DSR logic and data 
flow. The TSR module contains all DSR entry points except the interrupt entry. It accepts requests 
from and reports completions to the I/O supervisor of DX10. The primary function of the TSR is to 
provide a software interface to the peripheral device. The actual functions vary considerably 
based on the type of device. 

The TSR performs initial processing for all requests. The TSR calls the HSR for the output of data. 
The HSR stores output data in a transmit first-in, first-out (FIFO) buffer until the data can be trans- 
mitted on the communications line. 
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NOTE 

Buffered controllers such as the CI403 contain a hardware transmit 
FIFO. For non-buffered controllers such as the CI422, the HSR 
maintains a software transmit FIFO. 

The HSR cannot accept data when the transmit FIFO fills with data waiting to be transmitted. In 
this event, the TSR requests notification from the ISR when the HSR can accept more data. The 
user writing TSRs and ISRs defines a mechanism for the TSR to make this request to the ISR. This 
can be a flag set by the TSR and monitored by the ISR. The HSR notifies the ISR when it can 
accept more transmit data, and the ISR schedules the TSR using the DSR priority schedule or 
reenter-me mechanism. The TSR can then resume transferring output data to the HSR. Figure 
5-18 shows the logic paths followed in this process. Under normal conditions, the TSR reports 
completion of the output request before the HSR has actually transmitted all the data on the 
communications line. 

Read requests, in most cases, require the cooperation of the TSR and ISR modules. This discus- 
sion assumes a receive character queue is utilized to capture unsolicited input from the peripheral 
device. This is the KSB queue for SCI keyboard terminals. The receive character queue is a mecha- 
nism for passing data from the ISR to the TSR as indicated in Figure 5-18. The TSR attempts to 
satisfy the read by moving received data from the receive character queue to the user's read data 
buffer. When the TSR satisfies the read, it reports completion to the user task via the operating 
system I/O support routines. When the receive queue does not contain enough characters to sat- 
isfy the read, the TSR must wait. To do this, the TSR requests notification from the ISR when the 
receive character queue contains more data. The TSR requests notification using some mecha- 
nism defined by the writer of the TSR and ISR. This mechanism can be a flag set by the TSR and 
monitored by the ISR. The TSR then releases control. When the ISR stores data in the receive char- 
acter queue, it schedules the TSR for execution. Other I/O service requests are processed by the 
TSR with the aid of the ISR if required. 

The ISR module contains some functions that you can consider device support and some that you 
can consider controller support. The ISR module contains the interrupt entry to the DSR and uses 
an interrupt workspace different than the PDT workspace. The ISR module runs with controller 
interrupts masked; it calls the HSR to decode the controller interrupt. 

For the most part, ISR processing is independent of request processing of the DSR. Receive data 
is stored in the receive character queue even when no read request is active at the DSR. Error 
recovery action must be taken when the receive character queue becomes full. The ISR processes 
events requiring immediate attention. It also schedules the TSR module to start or resume 
processing. 

The HSR provides access to the controller hardware. It provides a generic interface to the con- 
troller. This allows other DSR modules to be written independent of the asynchronous controller 
type. HSR functions include controller and communications channel initialization, transmission 
of data, timer services, monitoring of modem signals, and controller interrupt decoding. The HSR 
does not support the concept of a read request. The HSR decodes the controller interrupt and 
reports the cause for the interrupt to the ISR. If the cause of the interrupt was a received data char- 
acter, the HSR also passes the data character back to the ISR. The HSR does not store the receive 
data. 
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5.5.2 Terminal Service Routine (TSR) 

The TSR module is the interface to the I/O subsystem of DX10. It must implement all the following 
DX10 interface functions similar to conventional DSRs: 

• DX10 I/O subsystem entry points 

— Power Restored 

— Abort/Time-Out 

— Reenter-me 

— SVC request 

— DSR priority schedule 

• Data structures 

— PDT 

— Buffered I/O request block 

— KSB/interrupt workspace 

• I/O subsystem routines 

— BZYCHK 

— ENDRCD 

— GETC 

— PUTCBF, PUTEBF 

— JMCALL, BRCALL, and BRSTAT 

— KEYFUN 

The following two mechanisms allow scheduling the TSR from an ISR: 

• Reenter-me 

• DSR priority schedule 

You can use these mechanisms in any DSR whether the DSR uses the asynchronous design or 
not. 
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Both of these mechanisms enter the DSR in the PDT workspace. The DSR is reentered when the 
next system clock interval expires if the reenter-me mechanism is invoked. The reenter-me mecha- 
nism is described in paragraph 5.4.5. Another mechanism for scheduling DSR non-interrupt pro- 
cessing (such as a TSR) from DSR interrupt processing (such as an ISR) is the DSR priority 
schedule mechanism. This mechanism reenters the DSR after all interrupt processing for the sys- 
tem is complete, but before the DX10 task scheduler or any task executes. This is a more direct 
reentry path to the DSR. It is intended for only the highest priority (non-interrupt) processing. If you 
use this mechanism arbitrarily, it can interfere with high priority processing of other DSRs. 

Table 5-9 describes the requirements for DSR (TSR) entry points when the DSR priority schedule 
mechanism is used. The first two entry point addresses (Power Up and Abort I/O) are defined by 
two DATA statements. These two entry point addresses reside at relative address and 2 of the 
DSR At DSR relative address 4, there must be a branch (B) instruction with its operand referencing 
the SVC entry point of the TSR. The DSR priority schedule entry point is at relative address 8. 

Table 5-9. DSR/TSR Entry Points 



Address Code Meaning 



0000 


DATA 


POWERU 


0002 


DATA 


ABORT 


0004 


B 


©SVCENT 


0008 


B 


@PRISCH 



DSR Power Up entry point address 
DSR Abort I/O entry point address 
Entry point to I/O Call routine 
Branch to scheduled routine 



Refer to the description of the DSR priority schedule mechanism in paragraph 5.4.6 for further 
details. You can define other interface mechanisms between the TSR and ISR within the con- 
straints of the operating system. Paragraph 5.6 describes the interface to the HSR. 

5.5.3 interrupt Service Routine (ISR) 

The ISR contains the interrupt entry to the DSR and executes in the interrupt workspace of the 

DSR. 

NOTE 

Each channel of an interface supported by the asynchronous DSR 
structure must have an interrupt workspace different than the PDT 
workspace. The CI402, CI421, and CI422 are not considered multiple 
channel interfaces. 
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The ISR interfaces with both the TSR and the HSR as well as the operating system interrupt 
decoder. The design of the TSR/ISR interface is not dictated by the asynchronous DSR design. For 
the most part, you can specify it to fit your needs. The following list provides examples of ISR 
functions for standard keyboard devices: 

• Bid application task 

• Suspend output 

• Abort output 

• Abort application task (hard break) 

Figure 5-19 shows the flow of control during interrupt processing. The PC component of the inter- 
rupt trap is an address within the operating system interrupt decoder. A controller interrupt trap 
gives control to the operating system interrupt decoder and starts its execution. The operating 
system decoder contains logic to determine which DSR is assigned to service the interrupting 
controller. The DSR is then entered at its interrupt entry point via a BLWP instruction. The work- 
space upon entry is the DSR interrupt workspace. This is the same workspace that the ISR uses. 

The ISR is responsible for controlling further interrupt decoding by the DSR. The ISR calls the HSR 
subroutine HNOTIF (refer to paragraph 5.6.9) to determine what type of controller interrupt 
occurred. The ISR provides return vectors for each interrupting condition of the controller 
Figure 5-19 uses the word VECTOR to denote this process. The description of the HNOTIF sub- 
routine documents the set of generic interrupt conditions. The HNOTIF subroutine takes the 
return vector associated with the current controller interrupt. 

The ISR code for the specific type of interrupt takes the proper action to service the interrupt. 
When complete, the ISR returns to the operating system interrupt decoder via a RTWP instruction 
The ISR can invoke the reenter-me or DSR priority schedule mechanism to cause the TSR to be 
executed. The operating system decoder takes the necessary action to restore normal system 
execution. . 

Figure 5-19 shows one other path for interrupt processing. The HSR exits/returns directly to the 
operating system interrupt decoder if the ISR calls HNOTIF when no controller interrupt is pend- 
ing. This special return exists to support certain ISRs; most user ISRs never use this path. 

5.5.4 Hardware Controller Service Routine (HSR) 

The generic interface to the HSR consists of a set of subroutines with a branch and link (BL) call 
interface. A subroutine implements one or more generic functions for the specific controller in 
use. For example, the TSR makes a Set DTR subroutine call. The HSR for a CRU controller might 
implement this as a SBO DTR CRU instruction. However, the HSR for a TILINE controller may 
™ ,.!? t nt the Same subroutlne b V usln 9 a SOC @DTR, @OUTSIG(R12) instruction to access the 
TILINE Peripheral Control Space (TPCS) of the controller. Identical requests from the TSR/ISR 
invoke identical functions for all controllers. Provision is made for controller hardware differ- 
ences. A "not supported" return is provided for most HSR subroutines. This return is taken when 
the requested function is not supported by the controller hardware. 
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Figure 5-19. Interrupt Processing Flow 



5.5.5 Asynchronous Data Structure Allocation 

The PDT extension contains two segments. One segment is physically contiguous to the PDT. 
This segment contains data that requires the most frequent access. The other segment contains 
data for which an increased access time does not significantly affect overall performance. This 
second segment must be accessed with long-distance instructions. Other data structures 
included in the long-distance extension are VDT screen images for screen image DSRs. Refer to 
Figure 5-20. 

All the data structures that are not accessed via long-distance instructions are allocated during 
system generation. These data structures are available when the operating system is loaded into 
memory from disk. The long-distance data structures must be allocated during the IPL of the oper- 
ating system. 
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This discussion references labels defined by data structure templates for the PDT extension for 
asynchronous DSRs. The first two words of this extension, PDXSMB and PDXSMP, provide access 
to a second long-distance PDT extension. These words must be initialized properly for user- 
written DSR's that use the asynchronous DSR structure (that is, DSRs that use an HSR provided 
by Texas Instruments). R11 of the PDT workspace must contain the address of PDXSMB. The first 
word of the extension, PDXSMB, should always be initialized (in source code) to contain the value 
> FFFF. The second word, PDXSMP, must contain the size in bytes of the long-distance PDT 
extension. This size must be at least 144 bytes for non-buffered controllers and at least 32 bytes 
for buffered controllers (CI403/CI404). You have the option of specifying additional space for the 
user-written TSR/ISR. You can also lengthen the local PDT extension by reserving more memory in 
the PDT provided to the system generation program. The pathname of the user PDT is identified 
during system generation in response to the PDT FILE prompt. 

5.6 HSR COMMON SUBROUTINES 

The information required to interface to the HSR module is as follows: 

• Subroutine names 

• Functions provided by each subroutine 

• Subroutine calling conventions 

The following paragraphs provide this information. 

The following list describes the HSR subroutine classes. Each class contains several subroutines. 
These subroutines provide one or more HSR functions. 

Power-up initialization 

Write output signal or function 

Read input signal or function 

Enable/disable status change notification 

Output a character 

Write operational parameters 

Read operational parameters 

Request timer interval notification 

Controller interrupt decoding 
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All HSR subroutines are called via BL instructions. Thus, they use the caller's workspace during 
execution. Parameters required by the subroutines are passed to the HSR in workspace registers. 
Information is returned to the caller in one of two ways. Data is returned to the caller in workspace 
registers. Other status is returned via alternate subroutine returns. The caller specifies alternate 
return addresses as operands of assembler DATA directives immediately following the BL subrou- 
tine call. The following shows an example of HSR alternate return addresses: 

BL @HSRSUB SUBROUTINE CALL 

DATA ALT1 FIRST ALTERNATE RETURN 

DATA ALT2 SECOND ALTERNATE RETURN 

< next instruction> NORMAL RETURN (CODE) 

The caller execution resumes at one of the alternate return addresses or at the normal return 
address (the instruction following all alternate return DATA statements). The number of alternate 
returns varies for different HSR subroutines. 

The HSR subroutines follow some general register conventions. The subroutines normally use RO 
and R10 as working registers. These two registers are also used when parameters are passed to or 
from the HSR. Exceptions are noted in some of the HSR subroutine descriptions, in most cases, 
R7 is used as a pointer to the PDT. This pointer points to the end of the required PDT. R12 contains 
the TILINE or CRU base address of the controller or controller channel. Other register usage is 
documented with specific HSR subroutines. 

5.6.1 Power-Up Initialization 

This subroutine class allows the HSR to perform any initialization required before operation 
begins. For the CI403 and CI404, the HSR must ensure that the controller has successfully exe- 
cuted the self-test for each channel specified during system generation. For other controllers, the 
HSR may be required to build a software transmit FIFO in a long-distance memory buffer that the 
operating system obtains. 

The three subroutines that perform power-up initialization functions are H RESET, HSWPWR, and 
HMRST. 

The HRESET subroutine performs power-up initialization that must be performed for all I/O chan- 
nels of the controller. This subroutine can be called once per channel for multiple channel con- 
trollers. However, there is only one master reset of the controller for each power-up occurrence. 

The HSWPWR subroutine performs ail channel-oriented initialization. The HSR data structures for 
the channel are initialized. Controller interrupts are enabled when the normal return is taken. 

The HMRST subroutine performs the same initialization functions as the HRESET routine except 
that a master reset of the controller is unconditionally performed. This subroutine is provided so 
that diagnostic software can force a controller master reset for testing purposes. 
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The TSR normally makes two calls to the HSR for power-up initialization. The HRESET subroutine 
is called first, followed by the HSWPWR subroutine. These two subroutines are called for each 
channel of the controller. The calling conventions are identical for each of the HSR power-up sub- 
routines. If HPOWER is considered a synonym for any of the three power-up subroutine names, 
then the calling conventions for all HSR power-up subroutines are as follows: 



Calling convention: 

BL ©HPOWER 

DATA XXXX 

< next instruction> 



POWER UP FAILURE RETURN VECTOR 
NORMAL RETURN (CODE) 



5.6.2 Write Output Signal or Function 

The subroutine names for setting output signals or functions to 1 (logic true) are of the form 
HSTxxx, where xxx specifies a signal or function. The subroutine names for resetting output sig- 
nals or functions to (logic false) are of the form HRTxxx, where xxx specifies a signal or function. 
The following list describes the output signals supported by HSRs: 



Subroutine 

HSTAL, HRTAL 
HSTDTR, HRTDTR 
HSTRTS, HRTRTS 
HSTSRS, HRTSRS 
HSTSRT, HRTSRT 



Signal 

AL — Analog Loopback 
DTR — Data Terminal Ready 
RTS — Request to Send 
DSRS — Data Signal Rate Select 
SRTS — Secondary Request to Send 
(or Reverse Channel Signal) 



The following list describes the output functions supported by HSRs: 

Subroutine Function 



HSTBIL, HRTBIL 
HSTCR, HRTCR 
HSTCTH, HRTCTH 
HSTRS, HRTRS 
HSTTB, HRTTB 
HSTUIL, HRTUIL 



BIL— Board Internal Loopback 

CR — Channel Reset 

CTH — Channel Transmitter Halt 

RS — Receiver Squelch 

TB — Set Transmit Break Condition 

UIL — UART Internal Loopback 
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The following paragraphs describe each of the functions in detail. 

HSTBIL Subroutine. The Set Board Internal Loopback subroutine HSTBIL sets a more general 
(controller or board) internal loopback mode than the universal asynchronous receiver/transmitter 
(UART) internal loopback mode. None of the current asynchronous controllers support this sec- 
ond level of loopback. 

HSTCR Subroutine. The Set Channel Reset subroutine HSTCR performs a hardware reset of the 
channel. This does not disturb any other communication channels, nor does it enable the channel 
interrupts. The HRTCR subroutine enables interrupts and allows normal operation. The following 
example shows a typical sequence for TSR use of these subroutines: 

1 . TSR issues an HSTCR call to quiet HSR activity on the channel. 

2. TSR issues an HSWPWR call to initialize the HSR data structures and status. 

3. TSR initializes its channel data structures and status. 

4. TSR issues an HRTCR call to begin normal operation. 

HSTCTH Subroutine. The Set Channel Transmitter Halt subroutine HSTCTH temporarily suspends 
output of data to the communications line. Any data in the transmit FIFO is not transmitted. The 
HRTCTH subroutine resumes transmission of data in the transmit FIFO. 

HSTRS Subroutine. The Set Receiver Squelch subroutine HSTRS enables half-duplex operation. 
The receiver squelch function disables reception of data during transmission. The HRTRS subrou- 
tine turns the receiver squelch off and allows full-duplex operation. 

HSTTB Subroutine. The Set Transmit Break subroutine HSTTB initiates the transmission of a 
break sequence (spacing/logic 0). This continues until stopped with the HRTTB subroutine. 

HSTUIL Subroutine. The Set UART Internal Loopback subroutine HSTUIL places the UART (com- 
munications chip) for the channel in loopback mode. In general, this causes the UART to return all 
transmitted data as received data on the same channel. Refer to UART documentation for more 
detailed information. The HRTUIL subroutine changes the UART from UART internal loopback to 
normal mode. 

The calling conventions for the HSTxxx and HRTxxx subroutines are identical. The following call- 
ing convention uses the HSTxxx name as an example: 

Calling convention: 

BL @ HSTxxx WHERE xxx IS DTR, RTS, ETC. 

DATA WW SIGNAL NOT SUPPORTED RETURN VECTOR 

< next instruction> NORMAL EXIT (CODE) 
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5.6.3 Read Input Signal or Function .. UCD 

This subroutine class allows reading controller input signals and HSR function states. The HSR 
subroutine name is of the form HRDxxx, where xxx identifies a signal or function. The following 
list describes the input signals or function states that can be read: 



Subroutine 

HRDBIL 

HRDCR 

HRDCTH 

HRDCTS 

HRDDCD 

HRDDSR 

HRDRI 

HRDSCT 

HRDSDC 

HRDSSS 

HRDTB 

HRDUIL 



Signal/Function 

BIL — Board Internal Loopback (Signal) 

CR — Channel Reset (Function) 

CTH — Channel Transmission Halted (Function) 

CTS — Clear to Send (Signal) 

DCD : — Data Carrier Detect (Signal) 

DSR — Data Set Ready (Signal) 

Rl — Ring Indicator (Signal) 

SCTS — Secondary Clear to Send (Signal) 

SDCD — Secondary Data Carrier Detect 

(or Speed Indication Signal) 
SSS — Split Speed Supported (Function) 
TB — Transmit Break (Function) 
UIL — UART Internal Loopback (Signal) 



Calling Convention: 

BL ©HRDxxx 
DATA WWWW 
DATA YYYY 
DATA ZZZZ 
< next instruction> 



WHERE xxx IS DSR, CTS, ETC. 
SIGNAL NOT SUPPORTED RETURN VECTOR 
CONTROLLER FAILURE RETURN VECTOR 
SIGNAL FALSE RETURN VECTOR 
SIGNAL TRUE RETURN (CODE) 



5.6.4 Enable/Disable Status Change Notification ._,.*, IUn T cd\ m 

This subroutine class provides a mechanism for the ISR (and therefore, indirectly th e TSR) to 
receive status change notification from the HSR. There are subroutines to enable notification and 
to disable notification. Once enabled, most of the signals or functions that are supported remain 
enabled until explicitly disabled. 

The Transmit Shift Register Empty (TSRE) function is an exception to this rule If the HSR makes a 
TSRE status notification, it automatically disables further notification for this same condl t on. 
You must enable the TSRE function with another HDSTSR call to the HSR . you want subsequent 
notification. Refer to the HSR interrupt decoder description for more details about the method ot 
notification. 

Notification is made when the signal changes from to 1 or from 1 to for theirs ^*e s^nals^ 
Some controllers notify only on the ring signal changing from to 1. The TSRE notification is 
made only when the condition occurs. 
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The subroutine names for enabling status change notification are of the form HESxxx, where xxx 
specifies a signal or function. The subroutine names for disabling status change notification are 
of the form HDSxxx, where xxx specifies a signal or function. The following list describes the noti- 
fication conditions that the HSR supports: 

Subroutine Status Change Notification 

HESCTS, HDSCTS CTS — Clear to Send 

HESDCD, HDSDCD DCD — Data Carrier Detect 

HESDSR, HDSDSR DSR — Data Set Ready 

HESRI, HDSRI R| — Ring Indicator 

HESSCT, HDSSCT SCTS - Secondary Clear to Send 

HESSDC, HDSSDC SDCD — Secondary Data Carrier Detect 

HESTSR, HDSTSR TSRE — Transmit Shift Register Empty 

The calling conventions for the HESxxx and HDSxxx subroutines are identical. The following call- 
ing convention uses the HESxxx name as an example: 

Calling Convention: 

BL @ HESxxx WHERE xxx IS DSR, Rl, ETC. 

DATA WW NOT SUPPORTED RETURN VECTOR 

< next instruction> NORMAL RETURN (CODE) 

5.6.5 Output a Character 

This HSR subroutine accepts characters to be output on the communications channel. The sub- 
routine provides a character interface to the output channel (that is, only one character is passed 
mi!^ e HSR f0r eaCh HOUTPx subroutine call). In all cases, the output data is stored in a transmit 
FIFO before transmission on the communications line. For buffered controllers, the FIFO is on the 
hardware controller. For non-buffered controllers, the FIFO is a software data structure that the 
HSR manages. An alternate (character not output) return from the HOUTPx routine is taken if the 
FIFO becomes full. The caller is responsible for saving the data character. The HSR notifies the 
ISR when the transmit FIFO is empty. This notification takes place as a "transmit interrupt" exit 
from the HSR interrupt decoder subroutine. This notification causes the output data to flow to the 
HSR again. Refer to the HSR interrupt decoder subroutine description for more details. 

The output character subroutines are HOUTP4 and HOUTP7. The only difference in these two sub- 
routines is that workspace register four (R4) contains the PDT pointer for the HOUTP4 subroutine 
and R7 contains the PDT pointer for the HOUTP7 subroutine. Refer to the PDTDIB description in 
Table 5-2. 
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Calling Convention: 

BL @HOUTPx x = 4 IF R4 IS PDT POINTER 

x = 7 IF R7 IS PDT POINTER 
DATA XXXX CHARACTER NOT OUTPUT — RETURN VECTOR 

< next instruction> NORMAL (CHARACTER OUTPUT) RETURN 

where: 

R4 or R7 contains the pointer to the PDT. 
R5 is the output character, left byte. 

Volatile Registers: 

RO and R5 

R5 preserved for character not output. 

5.6.6 Write Operational Parameters 

The following list describes the operational parameters that the HSRs support: 

• Baud rate selection — The transmit baud rate and the receive baud rate are specified in 
the most significant byte (MSB) and least significant byte (LSB) of RO, respectively. The 
MSB and LSB must be identical for controllers not supporting split speed. 

• Data format: 

— Parity selection: even, odd, mark, space, or none. 

— Character length selection: 5, 6, 7, or 8 bit data. 

— Stop bit selection: 1 , 1 .5, or 2 stop bits. 

The write parameters subroutines are Set Channel Speed (Baud Rate) and Set Data Character 
Format. The calling conventions for these two subroutines are very similar. The only difference is 
the parameter information passed in RO. 
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5.6.6.1 Set Channel Speed (Baud Rate). This subroutine specifies the transmit and receive 
speeds for the channel. The transmit and receive speeds may differ only when split speeds are 
supported. 

Calling Convention: 

BL @HSPSPD SET CHANNEL SPEED 

DATA WW PARAMETER NOT SUPPORTED RETURN VECTOR 

< next instructlon> NORMAL RETURN (CODE) 



where: 



RO MSB contains the transmit speed code; 
LSB contains the receive speed code. 
Refer to Table 5-10. 



Table 5-10. HSR Baud Rate Codes 



Speed Code 


Baud Rate 


00 


50 


01 


75 


02 


110 


03 


134.5 


04 


150 


05 


200 


06 


300 


07 


600 


08 


1,200 


09 


1,800 


0A 


2,400 


0B 


3,600 


OC 


4,800 


0D 


7,200 


0E 


9,600 


OF 


14,400 


10 


19,200 


11 -FF 


Reserved 
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5.6.6.2 Set Data Character Format. This subroutine sets the character length, parity selection, 
and the number of stop bits for data characters. 

Calling Convention: 

BL ©HSPPSL SET DATA CHARACTER FORMAT PARAMETERS 

DATA WW PARAMETER NOT SUPPORTED RETURN VECTOR 

< next instruction> NORMAL RETURN (CODE) 

where: 

RO contains the parameter information in the following format: 

Bit Contents 

- 1 Reserved 

2-3 Parity selection: 

00 = odd parity 

01 = even parity 
10 = mark parity 
11= space parity 

4 Parity enable (if 1) 

5-7 Reserved 

8-9 Number of stop bits: 

00 = 1 stop bit 

01 = 1.5 stop bits 

10 = reserved 

11 = 2 stop bits 
10-11 Data character length: 

00 = 5 bit character 

01 = 6 bit character 

10 = 7 bit character 

11 = 8 bit character 
12-15 Reserved 

5.6.7 Read Operational Parameters and Information 

This class of subroutines allows the following operational parameter values to be read from the 
HSR: 

Subroutine Operational Parameter Value 

HRPDAT HSR module revision level 

HRPPSL Data format: 

Parity selection: even, odd, mark, space, or none 

Character length selection 

Stop bit selection 
HRPSPD Baud rate 

HRPTYP Controller type ID 
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The parameter information is returned in RO of the caller's workspace. For the HRPSPD and 
HRPPSL subroutines, the format of the information in RO is identical to the format in the HSPSPD 
and HSPPSL subroutines, respectively. 

Calling Convention: 

BL ©HRPxxx WHERExxxISSPDORPSL 

< next instruction> RETURN 

The HRPDAT subroutine returns the current revision level of the HSR software module in RO. The 
revision level is a hexadecimal number starting at for the initial level and incrementing by 1 for 
each revision. The HRPTYP subroutine returns a code right justified in RO that identifies the con- 
troller type. Table 5-11 lists controller type codes. 

Table 5-11. Controller Type Codes 



Code Controller 



> 0001 CI401 (previously COMM l/F) 

> 0006 Business System 300 internal 9902 port 

> 0007 990/1 0A 9902 port 
>0008 CI402 

>0009 CI421 9902 port 

>000A CI422 

> 0023 CI403 

> 0024 CI404 
>0030 CI421 9903 port 



5.6.8 Request Time Interval Notification 

This subroutine (HTIMER) requests notification after a specified time interval. You specify the 
time interval as some number of 250-milllsecond periods. The HSR interrupt decoder performs the 
notification by taking the timer interrupt vector return to the ISR. Refer to the discussion of the 
HSR interrupt decoder for more details. You disable timer notification by specifying a zero as the 
number of 250-millisecond intervals (R0 = 0). A "not supported" exit is not provided for this 
subroutine. 

Calling Convention: 

BL ©HTIMER 
where: 

R0 specifies the number of 250-millisecond intervals. 
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5.6.9 Controller Interrupt Decoder 

The ISR calls this subroutine (HNOTIF) to perform controller interrupt decoding. The subroutine 
executes in the DSR interrupt workspace and with interrupts masked to the interrupt level of the 
controller channel. The ISR provides several return vector addresses via DATA directives immedi- 
ately following the call. A return vector is provided for each interrupt type possible from the con- 
troller. If the subroutine finds no controller interrupt pending, the return is to the operating system 
interrupt decoder rather than to the caller. 

Calling Convention: 



BL @HNOTIF 
DATA XXXX 
DATA YYYY 
DATA 7777 
DATA AAAA 
DATA BBBB 



RECEIVE INTERRUPT VECTOR 
TRANSMIT INTERRUPT VECTOR 
SIGNAL OR FUNCTION CHANGE VECTOR 
TIMER INTERRUPT VECTOR 
ILLEGAL/INVALID INTERRUPT VECTOR 



Receive Interrupt Return: 

R10 Received character left byte; line status in right byte. Line status is as follows: 

Bit Meaning 



0-2 
3 
4 
5 
6 
7 



Reserved 
Break received 
Framing error 
Parity error 
Overrun error 
Reserved 



Transmit Interrupt Return: 

This return is taken when the transmit FIFO empties. 
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Signal or Function Change Return: 

R10 Current signal or function states are returned in bits - 3 and bits 8-10. Bits 4-7 
and 12 - 15 are delta flags that indicate which signals or functions changed. 

Bit Contents 

DCD 

1 Rl 

2 DSR 

3 CTS 

4 Delta DCD 

5 Delta Rl 

6 Delta DSR 

7 Delta CTS 

8 SCTS 

9 SDCD 

10 TSRE 

1 1 Reserved 

12 Delta SCTS 

13 Delta SDCD 

14 Delta TSRE 

15 Reserved 

5.7 COMMON ROUTINES 

The following paragraphs describe the routines provided by DX10 for use in your DSR. Using these 
routines can reduce the code required for multiple routines that frequently perform the same oper- 
ations. You can also use them to remove DX10-specific routines from your DSR. 

5.7.1 BRCALL — Branch Table Call Routine 

This routine decodes the I/O sub-opcode in PRBOC in the buffered I/O request block and transfers 
control to the appropriate routine. When you enter BRCALL, R1 must contain the address of the 
buffered I/O request block, which contains the I/O sub-opcode in its first byte, as defined in para- 
graph 5.3.3. If you use the alternate entry point BRCALT, R0 must contain the sub-opcode. The 
routine leaves the contents of R1 unchanged, but modifies R0 and R11. 

5.7.1.1 Parameters. You must also supply a parameter list that contains the maximum number 
of sub-opcode processors, an error return address, and the address of each processor in order 
corresponding to the sub-opcode values. BRCALL decodes the sub-opcode and uses it as an 
index to the parameter list, where it obtains the address of the processor for the sub-opcode. 
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5.7.1.2 Calling Sequence. 

BL @BRCALL (or@BRCALT) 

DATA < highest legal sub-opcode (n)> 

DATA < error return address> 

DATA < sub-opcode processor address> 

DATA < sub-opcode 1 processor address> 



DATA < sub-opcode n processor address> 



5.7.2 BZYCHK — Busy Check Routine 

This routine determines whether the device was busy at the time of a power failure. You should 
call it in your Power Restored routine, which receives control when power is reapplied. BZYCHK 
runs in the PDT workspace. BZYCHK tests the busy flag (bit 1 of PDTDSF) in the PDT. 

• If it finds the busy flag set to one, BZYCHK checks the ENDRCD flag. If it is set, 
BZYCHK returns to the first word following the call. If it is not set, BZYCHK sets the 
reenter-me flag. In the call block pointed to by R7, BZYCHK sets the status code of the 
call block (PRBEC) to >04 to indicate that the device has lost a record due to the power 
failure. It also sets the error flag (bit 1 of PRBSFL). Then, it returns control to the DSR at 
the second word following the call. That word should contain a call to the end-of-record 
processor. 

• If it finds the busy flag set to zero, BZYCHK returns control to the DSR at the word fol- 
lowing the call. The instruction in this word should be a jump to the appropriate routine 
for handling the not-busy condition. 

5.7.2.1 Parameters. BZYCHK does not have formal parameters other than the instructions for 
branching to the busy and not-busy routines. On return, the contents of RO have been changed 
and not restored. 

5.7.2.2 Calling Sequence. 

MOV ©PDTSRB- PDTSIZ(R4),R7 LOAD THE CALL ADDRESS INTO REGISTER R7 

BL ©BZYCHK BRANCH AND LINK TO BZYCHK 

JMP NOTBSY JUMPTO NOT-BUSY ROUTINE 
< busy routine> 
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5.7.3 ENDRCD — End-of-Record Routine 

This routine notifies the operating system that the I/O operation has terminated by setting the 
end-of-record-needed flag (DSFEOR in PDTDSF) in the PDT. You should return control to the oper- 
ating system with a RTWP instruction following the return from ENDRCD. The operating system 
then returns the I/O request to the user task. If the DSR has detected an error, it should set the 
error flag (bit 1 of PRBSFL) in the buffered I/O request block before calling ENDRCD. 

The ENDRCD routine uses the following registers and does not restore them when it returns: 



RO 


R9 


R1 


R10 


R8 


R11 



5.7.3.1 Parameters. ENDRCD has no parameters other than PDTSRB must point to the I/O sub- 
opcode byte of the buffered I/O request block for the SVC whose I/O is completed. 

5.7.3.2 Calling Sequence. 

BL ©ENDRCD BRANCH AND LINK TO ENDRCD 

RTWP RETURN CONTROL TO DX10 

5.7.4 KEYFUN — Keyboard Function Routine 

This routine processes four special keys found on keyboard devices. These keys allow the key- 
board user to hold I/O, abort I/O, bid a task, or kill a task, depending on the sequence used. 

H0LD st °P s normal character interpretation by the DSR. The next keystroke 

determines the subsequent action. If the user presses a key other than 
HARD BREAK, ABORT, or BID, I/O resumes from the point where it was 
interrupted. (The Attention key serves as the HOLD key.) 

ABORT Aborts the I/O being processed. (The Return key serves as the ABORT 

key.) The active SVC call terminates with an error code of 06. 

B,D Blds SCI - CThe exclamation point (!) key serves as the BID key.) The op- 

erating system bids task 2 in .S$PROGA when this flag is set. 

HARD BREAK Terminates the task running at the terminal. (The Control/X key combina- 

tion serves as the HARD BREAK key.) The DSR does not need to take any 
special action for this to occur. The operating system bids task 2 in 
.S$PROGA when this flag is set. 

KEYFUN uses the KSB workspace and expects the input character to be in the upper byte of R10 
It compares the character to the HOLD, ABORT, BID, and HARD BREAK key values. When it 
detects a match, it sets the appropriate flag in R6 of the KSB and takes the special exit, which 
should skip normal DSR character buffering. Figure 5-21 depicts the use of KEYFUN in keyboard 
interrupt processing. 
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YES 



CALL 
PUTEBF 



GET CHARACTER 
USING 
CRU/TILINE 
INSTRUCTIONS 



CALL 
KEYFUN 



MATCH RETURN 




CALL 
PUTCBF 



-** 



/schedule dsfT\ 
( via reenter- j 

\^ME OR BLWPy 



228 3074 



f RTWP J 



Figure 5-21. Keyboard Interrupt Processing 
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5.7.4.1 Parameters. The four bytes following the KEYFUN call must contain the values for the 
HOLD, ABORT, BID, and HARD BREAK keys. The following word should contain the address of 
the special exit used to process those keys. 

5.7.4.2 Calling Sequence. 



MOV 


@CHAR,R10 


R10< = CHARACTER 


BL 


@ KEYFUN 


BRANCH AND LINK TO KEYFUN 


BYTE 


< hold key> 


'ATTENTION' KEY 


BYTE 


< abort key> 


'RETURN' KEY 


BYTE 


< bid key> 


'EXCLAMATION POINT' KEY 


BYTE 


< hard break key> 


'CONTROUX' KEY SEQUENCE 


DATA 


< special exit> 


RETURN ON MATCH 


<next 


instruction> 


RETURN ON NO MATCH 



5.7.5 GETC — Get Character Routine 

This routine retrieves a character from the KSB receive character queue for an interactive ter- 
minal. It uses the workspace in the PDT and assumes that R4 points to the KSB. 

GETC checks if the LUNO was opened for event characters and the call uses an extended call 
block. If not, GETC discards event characters until it finds a data character. If the LUNO is opened 
for event characters and the call uses an extended call block, GETC processes the first character 
it removes. The character is processed according to Table 5-1 2. 

Table 5-12. Character Ranges Used by GETC 



Code Character Type 



>00->7F Data 

> 80 - > 86 Event 
>87 - >95 Data 
>96 - >9A Event 

> 9B Ignored. Another character is removed. 
>9C->9F Event 

> A0 - > FF Data 



If the LUNO was opened for event characters but the call does not use an extended call block, the 
event character is placed back in the queue and the event character exit is taken. A Get Event 
Character SVC must be issued to remove the event character before more data characters can be 
read. 

The character is placed in R9 left justified and control is returned to the routine indicated in the 
Table 5-12. 
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If GETC finds no characters in the input buffer, it places the empty buffer routine address in R6 
and executes an RTWP instruction, returning control to the system. Because of this return, key- 
board DSRs that use GETC must use a special convention for returning control to the system. The 
DSR must load R6 with the address of the processor for the next interrupt before each return to 
the system, and the DSR entry for processing interrupts should consist of a branch to the address 
in R6, as follows: 

ISRENT MOV @ PDTSRB(R4),R1 R1< = SAVED PRB ADDRESS (PDTSRB) 
B *R6 RESUME EXECUTION 

5.7.5.1 Parameters. The call to GETC must be followed by two return points. The first provides 
a vector to the routine that handles an empty character buffer. The second provides a vector that 
handles event characters. The third return point is the instruction following the event character 
vector and is the routine for processing the data characters. 

5.7.5.2 Calling Sequence. 

BL @GETC 

DATA < empty buffer routine> 

DATA < event character routi ne> 

< first instruction of the data character routine is here> 

5.7.6 JMCALL — Jump Table Call Routine 

This routine decodes the I/O sub-opcode in the buffered I/O request block and transfers control to 
the appropriate routine. When you enter JMCALL, R1 must contain the address of the buffered I/O 
request block, which contains the I/O sub-opcode in its first byte as described in paragraph 5.3.3. 
If you use the alternate entry point JMCALT, RO upper byte must contain the sub-opcode. The rou- 
tine leaves the contents of R1 unchanged, but modifies RO and R1 1 . 

5.7.6.1 Parameters. You must also supply a parameter list that contains byte entries for the 
maximum number of sub-opcode processors, an error return address, and the address of each 
processor in order corresponding to the sub-opcode values. The entries for the error and sub- 
opcode processors give the offset in words (positive eight-bit value) from the label of the first byte 
in the list to the beginning of the processor. (Since the byte values are unsigned displacements, 
the displacement cannot exceed 255 words and cannot reference a processor that precedes the 
table.) For example, if the table begins at JTABLE and a processor begins at PROC1, you should 
use the following jump table entry for PROC1: 

BYTE (PROC1-JTABLE)/2 

JMCALL decodes the sub-opcode and uses it as an index to the parameter list, where it obtains 
the offset for the processor for the sub-opcode. This index is zero based. If the sub-opcode is 
greater that the highest legal sub-opcode, the routine takes the error routine exit. RO is destroyed. 
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5.7.6.2 Calling Sequence. 

BL @JMCALL (or@JMCALT) 

<table> BYTE < highest legal sub-opcode (n)> 

BYTE (< error return> - < table> )/2 

BYTE (< sub-opcode processor - < table> )/2 

BYTE (< sub-opcode 1 processor - < table> )/2 



BYTE (< sub-opcode n processor> - < table> )/2 

5.7.7 PUTCBF — Put Character in Buffer Routine 

This routine places a data character into the KSB input character queue. 

5.7.7.1 Parameters. PUTCBF expects to find a data character in the upper byte of R10 of the 
KSB workspace and the address of the input character queue in R2 and R3. If it finds the queues 
full, PUTCBF returns control to the routine indicated in the word following the call. Otherwise, it 
returns control to the second word following the call. 

5.7.7.2 Calling Sequence. 

MOV @CHAR,R10 R10< = DATA CHARACTER 

BL ©PUTCBF CALL PUTCBF 

DATA < buffer full routine> RETURN IF BUFFER FULL 

< next instruction> NORMAL RETURN 

5.7.8 PUTEBF — Put Event Character in Buffer Routine 

This routine places an event character in the KSB character queue. 

5.7.8.1 Parameters. PUTEBF sets bit of R10 of the KSB workspace to a one to make it an 
event character. If it finds the event character queue full, PUTEBF returns control to the routine 
indicated in the word following the call. Otherwise, it returns control to the second instruction fol- 
lowing the call. 

5.7.8.2 Calling Sequence. 

MOV @CHAR,R10 R10< = EVENT CHARACTER 

BL @ PUTEBF CALL PUTEBUF 

DATA < buffer full routine> RETURN IF BUFFER FULL 

< next instruction> NORMAL RETURN 



5-72 

946250-9705 



How to Write a Device Service Routine 



5.7.9 SETWPS — Set Interrupt Mask Routine 

This routine resets the interrupt mask so that the I/O Call routine can complete before the ISR 
must handle any interrupts. Your I/O Call routine should begin with a LIMI instruction to prevent 
an interrupt for the device during the execution of SETWPS. 

5.7.9.1 Parameters. SETWPS expects R2 of the DSR workspace to contain the current interrupt 
mask. It does not alter the workspace pointers. 

5.7.9.2 Calling Sequence. 

< initial entry> LIMI MASK ALL INTERRUPTS 

BL ©SETWPS CALL SETWPS 

< next instruction> RETURN POINT 

5.7.10 BRSTAT — Branch Table Call with Statistics Routine 

This routine performs the same function as BRCALL and JMCALL but also keeps a count for each 
type of I/O call. Each time BRSTAT is entered, an appropriate statistics counter is incremented in 
the PDT before branching to the specific opcode processor. 

5.7.10.1 Parameters. BRSTAT requires two tables: one that lists opcode processor entry points 
and one that lists offsets to counters in the PDT. The opcode processor entry table must immedi- 
ately follow the BL @ BRSTAT call and have as its first word a count of the number of entry points 
in the table. R10 is either for no statistics, or it is the address of the statistics table. The table 
contains a byte entry for each opcode handled by the DSR. If the byte value is 0, no statistics for 
that opcode are kept. Otherwise, the byte is used as an offset into the PDT from R4. (Refer to the 
asynchronous DSR example in Figure 5-22.) 

5.7.10.2 Calling Sequence. 

LI R10,STATTB 

BL @ BRSTAT 

DATA < highest legal sub-opcode (n)> 

DATA < error return address> 

DATA < sub-opcode processor address> 

DATA < sub-opcode 1 processor address> 



DATA < sub-opcode n processor address> 



STATTB BYTE > FC,> FD,> FC 
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SDSMAC 
ACCESS NAMES TABLE 

SOURCE ACCESS NAME= 

OBJECT ACCESS NAME= 

LISTING ACCESS NAME= 

ERROR ACCESS NAME= 

OPTIONS- 

MACRO LIBRARY PATHNAME* 



14:12:26 WEDNESDAY, JUN 28, 19 78 



PAGE 0001 



SYSBLD . DEVDSR . SOURCE . LPDSR 
SYSBLD . DEVDSR . OBJECT . LPDSR 
SYSBLD . DEVDSR. LIST . LPDSR 

XREF,TUNLST 



LINE 
0056 
0057 
0058 



KEY NAME 



DSC . SYSTEM . TABLES ( PDT ) 

- > SYSBLD . SYSTEM . TABLES ( PDT ) 
DSC . SYSTEM . TABLES ( LDT ) 

= > SYSBLD . SYSTEM . TABLES ( LDT ) 
DSC . SYSTEM . TABLES ( PRB ) 

»>SYSBLD. SYSTEM. TABLES (PRB) 



Figure 5-22. Example DSRs (Sheet 1 of 60) 
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LPDSR 



14:12:26 WEDNESDAY, JUN 28, 1978 



PAGE 00 2 



0001 

0002 

0003 

0004 

0005 

0006 

0008 

0009 

0010 

0011 

0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

0020 

0021 

0022 

0023 

0024 

0025 

0026 

0027 

0028 

0029 

0030 

0031 

0032 

0033 

0034 

0035 

0036 

0037 

0038 

0039 

0040 

0041 

0042 

0043 

0044 

0045 

0046 

0047 

0048 

0049 

0050 

0051 

0052 

0053 

0054 



*(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1977. ALL 
♦RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPOR- 
*ATED. RESTRICTED RIGHTS - USE, DUPLICATION OR DISCLOSURE 
♦SUBJECT TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE 
♦AGREEMENT AND ASSOCIATED DOCUMENTATION. 

IDT 'LPDSR' 
*=0=0=0=0=0=0=0=0*0=0=0=0»0=0-0»0=0=0=0=0=0=0=0=0=0=0=0=0=0 

* TITLE: LPDSR - LINE PRINTER DEVICE SERVICE ROUTINE 

* REVISION: 04/01/76 - ORIGINAL 

* REVISION: 06/01/76 - BLANK ADJUSTMENT 

* REVISION: 11/29/76 - DX10 REL. 3.0 

* COMPUTER: 990 

* ABSTRACT: 

* FOR PDTEMP =0 ST$DM EQU 

* THIS IS THE HANDLER FOR I/O TO VARIOUS MODELS 

* OF PRINTERS INTERFACED VIA THE STANDARD TI 

* PARALLEL INTERFACE, DATA MODULE. 

* FOR PDTEMP » 2 ST$EIA EQU 2 

* THIS IS THE HANDLER FOR I/O TO VARIOUS MODELS 

* OF THE CENTRONICS AND TI LINE PRINTERS, THAT 

* USE AN RS-232-C INTERFACE. 
* 

*«0=0»0=0=0=0=0=0=0=O a O=0=0=0=0=0=0=0=0 5S 0=0=0=O ss O=0=0=0=0=0 
* 

* EXTERNAL DEFINITIONS 
* 

DSR ADDRESS 
INTERRUPT ENTRY 
SPURIOUS INTERRUPT CLEAR 



SAVE WPS ROUTINE 
END-OF- RECORD ROUTINE 
PDT BUSY CHECK ROUTINE 
IOCOMX - JUMP CALL PROCESSOR 
ASCII CHARACTER CHECK 







DEF 


LPHAN 






DEF 


LP INT 




■ff 


DEF 


LPSPUR 




* 


EXTERNAL RE] 






REF 


SETWPS 






REF 


ENDRCD 






REF 


BZYCHK 






REF 


JMCALL 






REF 


ASCCHK 




it 


REF 


BYTE 40 




* 
* 


CRU 


BIT EQU 


0007 


EIAPAR 


EQU 


7 


0009 


EIADTR 


EQU 


9 


000B 


EIAWRQ 


EQU 


11 


000D 


EIANSF 


EQU 


13 


000E 


EIADSR 
* 


EQU 


14 


0007 


DMSTR 


EQU 


7 


0009 


DMVFC 


EQU 


9 


000D 


DMDMD 


EQU 


13 


000E 


DMINT 


EQU 


14 


000F 


DMCIN 


EQU 


15 



OUTPUT - DATA PARITY BIT 
OUTPUT - DATA TERMINAL READY 
INPUT/OUTPUT - (CLEAR) WRITE REQ 
INPUT - NEW STATUS 
INPUT - DATA SET READY 

OUTPUT - DATA OUTPUT STROBE 

OUTPUT - VERTICAL FORMS CONTROL 

OUTPUT - DEMAND FOR A CHARACTER 

OUTPUT - INTERRUPT ENABLE BIT 

OUTPUT - INTERRUPT ACKNOWLEDGE BIT 



Figure 5-22. Example DSRs (Sheet 2 of 60) 
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LPDSR 

LPDSR - LINE PRINTER DSR 



14:12:26 WEDNESDAY, JUN 28, 1978. 



PAGE 00 3 



0061 






0062 






0063 






0064 






0065 






0066 






0067 






0068 






0069 






0070 






0071 






0072 






0073 






0074 






0075 






0076 


0000 


OOCC 


0077 


0002 


00F8' 


0078 


0004 


0300 




0006 


0000 


0079 


0008 


06A0 




000A 


0000 


0080 


oooc 


0208 




000E 


0002 


0081 


0010 


06A0 




0012 


0000 


0082 


0014 


10 


0083 


0015 


ID 


0084 






0085 


0016 


oc 


0086 


0017 


09 


0087 


0018 


12 


0088 


0019 


OF 


0089 


001A 


12 


0090 


001B 


1A 


0091 


00 1C 


23 


0092 


001D 


23 


0093 


001E 


23 


0094 


001F 


ID 


0095 


0020 


ID 


0096 


0021 


15 


0097 


0022 


15 


0098 


0023 


12 


0099 


0024 


12 


0100 


0025 


23 



**o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o 

* ABSTRACT : 

* LPHAN - THIS IS THE MAIN ENTRY POINT INTO THE DSR 

* FOR THE POWER RESTORE ROUTINE (PWRON) , THE 

* ABORT I/O ROUTINE (ABORT) , AND THE I/O 

* ROUTINES. THE MAIN CODE BODY BEFORE THE JUMP 

* TABLE SETS UP THE WP, PC, AND ST FOR INITIAL 

* PROCESSING IN THE DSR. THE COUNTER IS USED 

* TO DETERMINE THE NUMBER OF OUTPUT CHARACTERS 

* FOR THE NON-WRITE OP CODES. THE JUMP TABLE 

* IS USED TO PASS CONTROL TO THE PROPER OP CODE 

* HANDLING ROUTINE VIA "JMCALL" . 
* 

**0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 



LPHAN 



BASE 



DATA PWRON 
DATA ABORT 
LIMI 

BL QSETWPS 



LI 



R8,2 



BL 9JMCALL 



POWER-UP ENTRY ADDRESS 
ABORT I/O ENTRY ADDRESS 
MASK INTERRUPTS 

SET RETURN - WPS 

INITIALIZE COUNTER 

JUMP TABLE PROCESSOR 



BYTE 16 

BYTE ILLOP-BASE/2S>FF 

BYTE OPEN-BASE/2&>FF 
BYTE CLOSE-BASE/2&>FF 
BYTE CLSEOF-BASE/2&>FF 
BYTE OPNRWD-BASE/2&>FF 
BYTE CLSUNL-BASE/2&>FF 
BYTE READST-BASE/2&>FF 
BYTE EXIT-BASE/2&>FF 
BYTE EXIT-BASE/2&>FF 
BYTE EXIT-BASE/2&>FF 
BYTE ILLOP-BASE/2&>FF 
BYTE ILLOP-BASE/2&>FF 
BYTE WRITEA-BASE/2&>FF 
BYTE WRITED-BASE/2&>FF 
BYTE WRTEOF-BASE/2&>FF 
BYTE RWND-BASE/2&>FF 
BYTE EXIT-BASE/2&>FF 



MAX OP CODE 
ILLEGAL OP RETURN 

00 OPEN 

01 CLOSE 

02 CLOSE EOF 

03 OPEN REWIND 

04 CLOSE UNLOAD 

05 READ STATUS 

06 FWD SPACE - IGNORE 

07 BAK SPACE - IGNORE 

08 DLT RECORD - IGNORE 

09 READ ASCII - ILLEGAL 
0A READ BINARY- ILLEGAL 
0B WRITE ASCII 

0C WRITE DIRECT 

OD WRITE EOF 

0E REWIND 

OF UNLOAD - IGNORE 



Figure 5-22. Example DSRs (Sheet 3 of 60) 
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LPDSR 14:12:26 WEDNESDAY, JUN 28, 1978. 

LPDSR - LINE PRINTER DSR PAGE 004 

0102 **o=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 

0103 * ABSTRACT: 

0104 * OPEN - PURGE BUFFER AND DO CRLF . 

0105 * OPNRWD - PURGE BUFFER AND PAGE EJECT. 

0106 * CLOSE - ISSUE LF TO DUMP BUFFER. 

0107 * CLSEOF - PAGE EJECT. 

0108 * WRTEOF - PAGE EJECT. 

0109 * RWND - PAGE EJECT. 

0110 * CLSUNL - PAGE EJECT. 

0111 * WRITEA - GET WRITE PARAMETERS FROM THE PRB. 

0112 * READST - CLEAR CHAR COUNT IN PRB. 

0113 * ILLOP - SET ERROR CODE AND RETURN. 

0114 * EXIT - SET INTERRUPT VECTOR AND EXIT. 

0115 * 

0H6 **o=0=0=0=0*0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 

0117 * 

0118 0026' CLOSE EQU $ 

0119 0026 0207 LI R7,CRLF 
0028 0112' 

0120 002A 1024 JMP TSTDSR 

0121 002C' OPEN EQU $ 

0122 002C 0207 LI R7,CR SET BUFFER PTR 
002E 0110' 

0123 0030 1021 JMP TSTDSR 

0124 0032' OPNRWD EQU $ 

0125 0032 0207 LI R7,PAGE1 
0034 010C' 

0126 0036 101F JMP TSTDSR 

0127 0038' CLSEOF EQU $ 

0128 0038' WRTEOF EQU $ 
,0129 0038' RWND EQU $ 
'0130 0038' CLSUNL EQU $ 

0131 0038 0207 LI R7,PAGE2 SET BUFFER PTR 
003A 010E' 

0132 003C 101B JMP TSTDSR 

0133 * 

0134 003E' WRITED EQU $ 

0135 00 3E' WRITEA EQU $ 

0136 003E ClEl MOV @PRBDBA-2 (Rl) , R7 BUFFER ADDRESS 
0040 0004 

0137 0042 C221 MOV @PRBCHT-2 (Rl) ,R8 CHARACTER COUNT 
0044 0008 

0138 0046 1016 JMP TSTDSR 

0139 * 

0140 0048 04E1 READST CLR @PRBCHT-2 (Rl) 
004A 0008 

0141 004C 1006 JMP EXIT 

0142 * 

0143 004E D860 ILLOP MOVB QBYTE02 , 9PRBEC-2 (Rl) ERROR CODE = 2 
0050 0064' 

0052 FFFF 

0144 0054 F860 EREXIT SOCB 9BYTE40 ,@PRBSFL-2 (Rl) SET ERROR FLAG IN PRB 
0056 0000 

0058 0002 

0145 00 5A' EXIT EQU $ STORE SYSTEM LOG INFO 

0146 005A D921 MOVB OPRBEC-2 (Rl) , QPDTERR-PDTSIZ (R4) 
005C FFFF 

005E FFE0 

0147 0060 3424 STCR @PDTSLl-PDTSIZ (R4) , 
0062 FFE6 

Figure 5-22. Example DSRs (Sheet 4 of 60) 
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LPDSR 

LPDSR - LINE PRINTER DSR 



14:12:26 WEDNESDAY, JUN 28, 19 78 



PAGE 000 5 



0148 0064' BYTE02 EQU $ 

0149 0064 0206 LI R6,LPSPUR 
0066 00EC' 

0150 0068 06A0 BL 9ENDRCD 
006A 0000 

0151 006C 0380 RTWP 



SPURIOUS INTERRUPT VECTOR 
GO TO END-OF- RECORD ROUTINE 



Figure 5-22. Example OSRs (Sheet 5 of 60) 
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LPDSR 

LPDSR - LINE PRINTER DSR 



14:12:26 WEDNESDAY, JUN 28, 1978. 



PAGE 0006 



0153 
0154 
0155 
0156 
0157 
0158 
0159 
0160 
0161 
0162 
0163 
0164 
0165 
0166 
0167 
0168 
0169 
0170 
0171 
0172 
0173 
0174 
0175 
0176 
0177 
0178 
0179 
0180 
0181 
0182 
0183 
0184 
0185 
0186 
0187 
0188 

0189 

0190 
0191 
0192 
0193 
0194 
0195 
0196 
0197 
0198 
0199 

0200 
0201 
0202 
0203 
0204 
0205 
0206 
0207 
0208 
0209 



006E 
0070 
0072 

0074 
0076 
0078 
007A 
007C 
007E 
0080 
0082 

0084 
0086 
0088 
008A 
008C 
008E 
0090 
0092 
0094 
0096 

0098 
009A 
009C 
009E 
00A0 
00A2 
00A4 
00A6 



006E" 

1F0B 

1618 

1E0B 

0074" 

0754 

1604 

1D07 

1F0D 

13 IB 

1002 

1F0E 

1618 

0084 J 

0608 

11E9 

D277 

0249 

7F00 

0289 

1300 

13F8 

0754 

1308 

31C9 

ICO 2 

1E07 

1001 

1D07 

0206 

006E' 

0380 



**o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o 

* ABSTRACT : 

* TSTWRQ - THIS ROUTINE IS ENTERED UPON RECEIPT OF AN 

* INTERRUPT FROM AN EIA INTERFACED LP. WRITE 

* REQUEST MUST GO HIGH BEFORE PRECEEDING TO 

* OUTPUT ANOTHER CHARACTER. 

* TSTDSR - THIS ROUTINE IS ENTERED UPON RECEIPT OF AN 

* INTERRUPT FROM A DM INTERFACED LP, WRITE 

* REQUEST FOR AN EIA I/F'D LP HAS GONE HIGH, OR 

* THIS IS THE INITIAL CHARACTER BEING OUTPUT TO 

* THE LP. CERTAIN CHARACTERS LESS THAN 20 ARE 

* SCREENED FROM BEING OUTPUT TO THE LP EXCEPT IN 

* THE CASE WHERE THE SYSGEN PARAMETERS AND THE 

* USER SPECIFY THAT THE PRINTER IS CAPABLE OF 

* HANDLING THE CHARACTERS. 
* 

**o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o 

* 

ENTER HERE ON INTERRUPTS 
WRITE REQUEST HIGH? 
NO, WAIT FOR IT 
YES, RESET IT 
INITIAL OUTPUT ENTRY 
DM INTERFACED LP ? 
NO - 

YES- INITIALIZE STROBE 
DEMAND UP ? 
NO -WAIT FOR IT 
YES- 

DATA SET READY ? 
NO - WAIT FOR IT 



TSTWRQ EQU 
TB 
JNE 
SBZ 

TSTDSR EQU 
ABS 
JNE 
SBO 
TB 
JEQ 
JMP 

EIATST TB 
JNE 

DECCNT EQU 
DEC 
JLT 



00A8 
00AA 
00 AC 
00AE 
00B2 
00B2 
00B4 



0549 
31C9 
1E07 
1000 
1D07 
10E0 
0206 



$ 

EIAWRQ 
WAITWR 
EIAWRQ 
$ 

*R4 

EIATST 
DMSTR 
DMDMD 
WAITDS 
DECCNT 
EIADSR 
WAITDS 
$ 

R8 

EXIT 
MOVB *R7+,R9 
AND I R9,>7F00 



CI R9,>1300 



LDCHR 



JEQ 
ABS 
JEQ 



DECCNT 

*R4 

DMLCHR 



SBZ 
JMP 
SETONE SBO 
WAITWR LI 



LDCR R9,7 
JOP SETONE 
EIAPAR 
WAITWR 
EIAPAR 
R6 , TSTWRQ 



YES- DONE WITH THE RECORD ? 
YES- LEAVE 
NO - GET NEXT CHAR 
SET PARITY BIT 

DESELECT CHARACTER? 

YES - SKIP IT 
DM INTERFACED LP ? 
YES— 

EIA OUTPUT CHARACTER SEQUENCE 
NO - LOAD CHARACTER 

SET PARITY BIT AS NEEDED 



RTWP 



DMLCHR INV R9 

LDCR R9,7 

SBZ 

NOP 

SBO 

JMP 
WAITDS LI 



DMSTR 

DMSTR 
TSTDSR 
R6, TSTDSR 



DM CHARACTER OUTPUT SEQUENCE 
INVERT THE CHARACTER 
OUTPUT THE CHARACTER TO THE I/F 
STROBE THE I/F 



Figure 5-22. Example DSRs (Sheet 6 of 60) 
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LPDSR 14:12:26 WEDNESDAY, JUN 28, 1978. 

LPDSR - LINE PRINTER DSR PAGE 0007 

00B6 0074' 
0210 00B8 0380 RTWP 



Figure 5-22. Example OSRs (Sheet 7 of 60) 
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LPDSR 

LPDSR - LINE PRINTER DSR 



14:12:26 WEDNESDAY, JUN 28, 1978. 



PAGE 0008 



0212 
0213 
0214 
0215 
0216 
0217 
0218 
0219 
0220 
0221 
0222 
0223 
0224 
0225 
0226 
0227 
0228 
0229 
0230 
0231 



0232 
0233 
0234 
0235 
0236 
0237 
0238 
0239 
0240 
0241 

0242 
0243 

0244 
0245 

0246 
0247 
0248 
0249 
0250 
0251 

0252 
0253 
0254 
0255 
0256 

0257 
0258 



0259 

0260 
0261 



00BA 
OOBC 
OOBE 
OOCO 
00C2 
00C4 
00C6 
00C8 
OOCA 

OOCC 
OOCE 
OODO 
00D2 
00D4 
00D6 
00D8 
OODA 
OODC 
OODE 
OOEO 
00E2 
0OE4 
00E6 
00E8 
OOEA 



0754 
1602 
1E0F 
1001 
1E0D 
C924 
FFFA 
FFFC 
0456 

0754 

1604 

1E0F 

1D0E 

1D09 

1003 

1D09 

3020 

0114' 

C1C1 

06A0 

0000 

1006 

0206 

005A' 

0380 



**o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o 

* ABSTRACT • 

* LPINT - THIS IS THE ENTRY POINT FOR DEVICE 

* INTERRUPT. THE TIME-OUT COUNTER IS RESET AND 

* THE PROPER ROUTINE IS ENTERED VIA R6 . 

* PWRON - THIS ROUTINE IS ENTERED WHEN THE SYSTEM 

* INITIALLY STARTS AND WHEN THE SYSTEM RECOGNIZES 

* A POWER RE-START. THE INTERFACE IS PROPERLY 

* INITIALIZED. 

* LPSPUR - HANDLE SPURIOUS INTERRUPTS. 

* ABORT - THIS ROUTINE HANDLES I/O ABORT. 

**0-0«0-0«0*0»0=0»0«0=0»0=0=0*0»0»0»0=0=0=0=0=0=0«0=0=0=0=0 

* 

LPINT ABS *R4 DM INTERFACED LP ? 

JNE LPI$05 NO - 

SNZ DMCIN YES- CLEAR INPUT INTERRUPT 

JMP LPI$10 

LPI$05 SBZ EIANSF CLEAR NEW STATUS INT 



LPI$10 MOV 9PDTIMKR4) ,@PDTIM2(R4) 



* 
PWRON 



PWR$05 
PWR$10 



B 

ABS 
JNE 
SBZ 
SBO 
SBO 
JMP 
SBO 



*R6 

*R4 

PWR$05 

DMCIN 

DMINT 

DMVFC 

PWR$10 

EIADTR 



LDCR §INIT,0 



OOEC 0754 
OOEE 1301 
00F0 1E0B 
00F2 0206 
00F4 OOEC 
00F6 0380 



LPSPUR 
NOTBZY 



MOV 
BL 

JMP 
LI 

RTWP 

ABS 
JEQ 
SBZ 

LI 

RTWP 



Rl,R7 
QBZYCHK 

NOTBZY 
R6,EXIT 



*R4 

NOTBZY 
EIAWRQ 
R6, LPSPUR 



00F8 

OOFA 
OOFC 
OOFE 
0100 
0102 
0104 
0106 
0108 
010A 



C1C1 

OOFA' 

06A0 

00E2' 

10AD 

D860 

OOFA' 

FFFF 

0242 

FBFF 

10A4 



ABORT MOV Rl , R7 

BYTE 06 EQU $ 

BL (9BZYCHK 

JMP EXIT 



DM INTERFACED LP ? 

NO - 

YES- CLEAR INPUT INTERRUPTS 

ENABLE INTERRUPTS 

DISABLE VFC 



* INITIALIZE INTERFACE 

R7=PRB ADDRESS 

GO TO BUSY CHECK ROUTINE 

NOT BUSY RETURN 
BUSY RETURN 



DM INTERFACED LP ? 
YES- 

NO - RESET INTERRUPT 
AND IGNORE IT 



R7=PRB ADDRESS 
GO TO BUSY CHECK 
NOT BUSY RETURN 



MOVB §BYTE06,@PRBEC-2(R1) BUSY RETURN, ERROR CODE=6 



AND I 2, > FBFF 
JMP EREXIT 



RESET REENTER-ME FLAG 
EXIT 



Figure 5-22. Example DSRs (Sheet 8 of 60) 



946250-9705 



5-81 



How to Write a Device Service Routine 



LPDSR 










1 


LPDSR 


- LINE PRINTER DSR 




0262 






* 






0263 


010C 


7F 


PAGE1 


BYTE 


>7F 


0264 


010D 


oc 




BYTE 


>0C 


0265 


010E 


OD 


PAGE2 


BYTE 


>0D 


0266 


010P 


OC 




BYTE 


>0C 


0267 


0110 


7P 


CR 


BYTE 


>7F 


0268 


0111 


OD 




BYTE 


>0D 


0269 


0112 


OA 


CRLP 


BYTE 


>oa 


0270 


0113 


OD 




BYTE 


>od 


0271 


0114 


4600 


INIT 


DATA 


>4600 


0272 








END 




NO ERRORS 











14:12:26 WEDNESDAY, JUN 28, 1978. 



PAGE 00 9 



DATA TABLES FOR THE NON-OUTPUT 

CR 

FF 



NUL 
CR 



INITIALIZE INTERFACE LDCR VALUE 



Figure 5-22. Example DSRs (Sheet 9 of 60) 
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LPDSR 
LABEL 



14:12:26 WEDNESDAY, JUN 28, 1978. 



VALUE DEFN REFERENCES 



PAGE 0010 



0116' 



ABORT 00F8' 

ASCCHK R 

BASE 0014' 



BYTE 02 


0064' 


BYTE06 


00FA' 


BYTE40 R 


0056' 


BZYCHK R 


00FC' 


CLOSE 


0026' 


CLSEOF 


0038' 


CLSUNL 


0038' 


CR 


0110' 


CRLF 


0112' 


DECCNT 


0084' 


DMCIN 


0OOF 


DMDMD 


000D 


DMINT 


000E 


DMLCHR 


00A8' 


DMSTR 


0007 


DMVFC 


0009 


DSFASG 


0000 


DSFBSY 


0001 


DSFCLS 


0004 


DSFEOR 


0006 


DSFINT 


0002 


DSFKLL 


0003 


DSFREN 


0005 


DTFCOM 


0005 


DTFFIL 


0000 


DTFKSB 


0004 


DTFPRI 


0003 


DTFSYD 


0006 


DTFTIL 


0001 


DTFTIM 


0002 


EIADSR 


000E 


EIADTR 


0009 


EIANSF 


000D 


EIAPAR 


0007 


FIATST 


0080' 


EIAWRQ 


000B 


ENDRCD R 


006A' 


EREXIT 


0054' 


EXIT 


005A' 


ILLOP 


004E' 


INIT 


0114' 


JMCALL R 


0012' 


LDCHR 


0094' 


LDFAIO 


000D 


LDFANC 


0000 


LDFBSY 


000A 


LDFCBA 


0003 


LDFFIL 


0009 


LDFIIO 


OOOC 


LDFRCM 


000B 


LDFSYS 


0008 


LDFTAP 


OOOF 


LDFUNB 


000E 



0254 
0039 
0082 

0148 
0255 
0040 
0037 
0118 
0127 
0130 
0267 
0269 
0184 
0054 
0052 
0053 
0203 
0050 
0051 
A0010 
A0011 
A0014 
A0016 
A0012 
A0013 
A0015 
A0023 
A0018 
A0022 
A0021 
A0024 
A0019 
A0020 
0048 
0045 
0047 
0044 
0182 
0046 
0036 
0144 
0145 
0143 
0271 
0038 
0191 
B0021 
B0010 
B0018 
B0012 
B0017 
B0020 
B0019 
B0016 
B0023 
B0022 



A0008 A0008 A0034 A0034 A0035 A0035 A0036 A0036 A0052 
A0053 B0036 C0017 0118 0121 0124 0127 0128 0129 

0130 0134 0135 0145 0148 0171 0175 0184 0255 

0077 



0083 
0093 
0143 
0258 
0144 
0243 
0086 
0087 
0089 
0122 
0119 
0181 
0228 
0179 
0237 
0192 
0178 
0238 



0085 
0094 



0256 



0086 
0095 



0087 
0096 



0088 
0097 



0089 
0098 



0090 
0099 



0091 
0100 



0092 



0182 

0240 

0230 

0196 

0177 

0172 

0150 

0260 

0091 

0083 

0241 

0081 



0190 
0236 



0205 0207 



0198 

0174 0250 



0092 
0094 



0093 
0095 



0100 0141 0186 0245 0257 



Figure 5-22. Example DSRs (Sheet 1 of 60) 
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LPDSR 
LABEL 

LDTBLK 

LDTBN 

LDTFCB 

LDTFLG 

LDTFLL 

LDTFWT 

LDTIOC 

LDTLDT 

LDTLRN 

LDTLUN 

LDTNU 

LDTOCB 

LDTORC 

LDTPDT 

LDTSIZ 

LDTTSB 

LPHAN D 

LPI$05 

LPI$10 

LPINT D 

LPSPUR D 

NOTBZY 

OPEN 

OPNRWD 

PAGE1 

PAGE2 

PDT$ 

PDTBLN 

PDTBUP 

PDTCRU 

PDTDIB 

PDTDSF 

PDTDSR 

PDTDTF 

PDTDVQ 

PDTEMP 

PDTERR 

PDTFLG 

PDTIM1 

PDTIM2 

PDTINT 

PDTLNK 

PDTMAP 

PDTNAM 

PDTPRB 

PDTRO 

PDTR10 

PDTR11 

PDTR13 

PDTR14 

PDTR15 

PDTR5 

PDTR6 

PDTR7 

PDTR8 

PDTR9 

PDTSIZ 

PDTSL1 

PDTSL2 

PDTSRA 



VALUE DEFN REFERENCES 



14:12:26 WEDNESDAY, JUN 28, 1978 



PAGE 0011 



0018 

0012 

000C 

0004 

000A 

0007 

0003 

0006 

000E 

0002 

001B 

0016 

001A 

0000 

001C 

0008 

0000" 

00C2' 

00C4' 

OOBA" 

OOEC" 

00F2' 

002C 

0032' 

010C* 

010E' 

0024 

0034 

0032 

001C 

000C 

0008 

0026 

000A 

0038 

0048 

0028 

0029 

FFFA 

FFFC 

0036 

0000 

0002 

002A 

0006 

0004 

0018 

001A 

00 IE 

0020 

0022 

000E 

0010 

0012 

0014 

0016 

0048 

002E 

0030 

FFDE 



0029 
0227 
0229 
0030 

0031 0149 
0249 



0251 



B0032 

B0030 

B0028 

B0008 

B0027 

B0015 

B0007 

B0025 

B0029 

B0006 

B0034 

B0031 

B0033 

B0005 

B0036 

B0026 
0076 
0230 
0231 
0226 
0248 

0251 0244 
0121 0085 
0124 0088 
0263 0125 
0265 0131 
A0037 
A0045 
A0044 
A0033 
A0025 
A0009 

A0038 A0056 
A0017 
A0047 

A0053 A0025 
A0039 0146 
A0040 

A0054 0231 
A0055 0231 
A0046 
A0005 
A0006 
A0041 
A0008 

A0007 A0037 
A0031 
A0032 
A0034 
A0035 
A0036 
A0026 
A0027 
A0028 
A0029 
A0030 

A0052 A0054 A0055 A0056 A0057 0146 0147 
A0042 0147 
A0043 
A0056 



Figure 5-22. Example DSRs (Sheet 1 1 of 60) 
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LPDSR 
LABEL 

PDTSRB 

PDTTMl 

PDTTM2 

PRBCHT 

PRBDBA 

PRBEC 

PRBLUN 

PRBOC 

PRBRLN 

PRBRN1 

PRBRN2 

PRBSFL 

PRBSIZ 

PRBSOC 

PRBUFL 

PWR$05 

PWR$10 

PWRON 

Rl 

R4 

R6 

R7 

R8 

R9 

READST 

RWND 

SAVPRB 

SETONE 

SETWPS R 

TSTDSR 

TSTWRQ 

WAITDS 

WAITWR 

WRITEA 

WRITED 

WRTEOF 



VALUE DEFN REFERENCES 



14:12:26 WEDNESDAY, JUN 28, 1978. 



PAGE 0012 



0046 

0042 

0044 

000A 

0006 

0001 

0003 

0002 

0008 

000C 

OOOE 

0004 

0010 

0000 

0005 

00D8" 

00DE' 

00CC' 

0001 

0004 

0006 

0007 

0008 

0009 

0048' 

0038' 

FFFE 

00A0" 

000A' 

0074' 

006E' 

00B4' 

00A2' 

003E' 

003E' 

0038' 



A0050 
A0048 
A0049 
C0013 
C0011 
C0006 
C0008 
C0007 
C0012 
C0014 
C0015 
C0009 
C0017 
C0005 
C0010 
0240 
0242 
0234 



A0057 
A0054 
A0055 

0137 0140 

0136 

0143 0146 



0140 
0129 
A0057 
0198 
0035 
0175 
0171 
0209 
0199 
0135 
0134 
0128 



0144 



0235 
0239 
0076 
0136 
0146 
0149 
0119 
0080 
0187 
0090 
0099 

0195 
0079 
0120 
0199 
0180 
0173 
0096 
0097 
0098 



0137 
0147 
0199 
0122 
0137 
0188 



0258 



0143 
0191 
0232 



0140 
0176 
0209 
0125 
0185 
0189 0194 



0144 
0226 
0245 



0131 0136 



0146 0242 
0231 0231 
0251 
0187 



0254 
0234 



0242 0254 



0258 
0248 



0203 0204 



0123 0126 0132 0138 0208 0209 

0183 
0197 



Figure 5-22. Example DSRs (Sheet 1 2 of 60) 
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SDSMAC 3.6.0 


ACCESS 


NAMES ' 


TABLE 


SOURCE 


ACCESS 


NAME= 


OBJECT 


ACCESS 


NAME= 


LISTING ACCESS NAME= 


ERROR ACCESS 1 


NAME= 


OPTIONS' 




MACRO LIBRARY 


PATHNAME* 


LINE 


KEY 


NAME 


0001 


A 


DSC.CONDA 



0115 



0116 



0117 



0118 



0119 



0120 



83.111 13:16:24 FRIDAY, MAY 06, 1983 

D2 . AMX . OSM .DX . DEVDSR. SOURCE . DSSPTSR 
D2 . AMX . OSM . DX . DEVDSR . OBJECT . DSSPTSR 
D2 . AMX . OSM . DX . DEVDSR . LIST . DSSPTSR 

f{*{ 
XREF 



=>D2.AMX.OSM.DX.CONDASM.OS 
DSC . SYSTEM . TABLES . DSRIRB 

= >D2 . AMX . OSM . DX . SYSTEM . TABLES . DSRI RB 
DSC . SYSTEM . TABLES . DSRPDT 

=>D2. AMX. OSM. DX. SYSTEM. TABLES. DSRPDT 
DSC . SYSTEM . TABLES . KSB 

=>D2 . AMX . OSM. DX . SYSTEM . TABLES . KSB 
DSC . SYSTEM . TABLES . AJMPMAC 

= > D2 . AMX . OSM . DX . SYSTEM . TABLES . AJMPMAC 
DSC . SYSTEM . TABLES . DSALLLEX 

=■ > D2 . AMX . OSM . DX . SYSTEM . TABLES . DSALLLEX 
DSC . SYSTEM . TABLES . DSALLREX 

- > D2 . AMX . OSM . DX . SYSTEM . TABLES . DSALLREX 



PAGE 0001 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 

PAGE 002 

0001 COPY DSC.CONDASM.OS 

0010 0000 

0015 IDT 'DSSPTSR' 

0019 * 

0020 * (C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. 

0021 * ALL RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS 

0022 * INCORPORATED. RESTRICTED RIGHTS ~ USE, DUPLICATION, OR 

0023 * DISCLOSURE SUBJECT TO RESTRICTIONS SET FORTH IN TI'S 

0024 * PROGRAM LICENSE AGREEMENT AND ASSOCIATED DOCUMENTATION. 

0025 * 

0026 * 

0027 * 

qq23 ************************************************************ 

0029 * TITLE: ASYNC TERMINAL SUBSYSTEM SERIAL PRINTER TSR 

0030 * REVISION: 01/26/83 ORIGINAL 

0031 * COMPUTER: 990 
00 32 * ABSTRACT: 

0033 * THIS IS THE TERMINAL SERVICE ROUTINE FOR THE 

0034 * SERIAL PRINTER DSR. IT PROVIDES THE PROCESSING 

0035 * OF I/O CALLS TO THE DEVICE AND INTERRUPTS 

0036 * GENERATED BY THE DEVICE. 

0037 * 

0038 * THE DSR HAS ENTRY POINTS TO FOUR ROUTINES 

0039 * WHICH PROCESS DIFFERENT STATES OF I/O: 

0040 * 

0Q41 * PWRON - POWER RESTORED ROUTINE 

0042 * THIS ROUTINE IS ENTERED WHEN POWER IS 

0043 * RESTORED OR WHEN DX10 IS LOADED. THE 

0044 * DEVICE INTERFACE IS INITIALIZED HERE. 

0045 * THE ENTRY POINT OF THIS ROUTINE IS DEFINED 

0046 * IN THE FIRST WORD OF THE DSR. 

0047 * 

004 8 * ABORT - I/O ABORT ROUTINE 

004 9 * THE DSR IS ENTERED HERE WHEN A DEVICE TIME- 

0050 * OUT OCCURS OR A KILL I/O SUPERVISOR CALL 

0051 * IS ISSUED. 

0052 * 

0053 * HANSLP - INITIAL I/O CALL HANDLER 

0054 * THE THIRD WORD OF THE DSR IS THE INITIAL 

0055 * ENTRY POINT OF THE DX10 I/O SUPERVISOR TO 

0056 * HSR TEST. THE I/O CALLS OF USER TASKS ARE 

0057 * PROCESSED IN THIS ROUTINE. 

0058 * 

0059 * REMSLP - REENTER-ME PROCESSING 

0060 * REENTER-ME IS USED START AND CONTINUE 

0061 * CHARACTER OUTPUT TO THE PRINTER. 

0062 * 

0063 * 
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DSSPTSR 

0065 

0066 

0067 

0068 

0069 

0070 

0071 

0072 

0073 

0074 

0075 

0076 

0077 

0078 

0079 

0080 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
DX10 - TSR SECTION - PDT WORKSPACE 

* EXTERNAL DEFINITIONS 



PAGE 000 3 



DEF A13HAN,A23HAN,A33HAN 
DEF Al 3 INT, A2 3 INT, A3 3 INT 
DEF A13REM,A23REM,A33REM 



GLOBAL - START OF DSR 
GLOBAL - INTERRUPT ENTRY 
GLOBAL - REENTER-ME ENTRY 



COMMON EXTERNAL REFERENCES 



0001 IRB 
0007 PDT 
0000 TT 



REF BRSTAT 

REF ENDRCD 

EQU Rl 

EQU R7 

EQU 



OPCODE JUMP TABLE ROUTINE 
END OF RECORD ROUTINE 



SET MACRO JUMP TABLE = TSR 
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DSSPTSR SDSMAC 
DSSPTSR - DX10 - 

0082 

0109 0000 

0113 

0114 

0115 

B0001 

B0002 

B0003 

B0004 

B0005 

B0006 

B0007 

B0008 

B0009 

B0010 FFFE 
BOOH FFFE 00 
B0012 FFFF 00 

B0013 

B0014 0000 

B0015 0000 

B0016 0001 

B0017 0002 

B0018 

B0019 

B0020 

B0021 

B0022 

B0023 0003 

B0024 



3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
TSR SECTION - PDT WORKSPACE 



PAGE 0004 



B0025 

B0026 

B0027 

B0028 

B0029 

B0030 

B0031 

B0032 

B0033 

B0034 

B0035 

B0036 

B0037 

B0038 

B0039 

B0040 

B0041 

B0042 

B0043 



00 
00 
00 
0000 
0001 
0002 
0003 
0007 
00 
0000 
0001 
0001 
0001 
0001 
0002 
0003 
0003 
0004 
0018 
0004 
0005 
0005 
0005 
0005 
0006 
0006 
0007 
0007 
0007 



REF BYTE02 UNDEFINED BIT IN PDTERR(PDT) 

REF MASTAB TABLE OF WORD DEFINITIONS 

COPY DSC. SYSTEM. TABLES. DSRIRB 
********************************************************* 



PHYSICAL RECORD BLOCK (DSRIRB) 10/26/81 

POINTED TO BY Rl IN DEVICE SERVICE ROUTINES, 



* REVISION 

* 03/02/82 - ADD FLAG FOR ON-LINE DIAG 

* PROCESSING. 
*********************************************************** 



B0044 0004 0000 

B0045 0006 0000 

B0046 0008 0000 

B0047 000A 0000 

B0048 0008 

B0049 

B0050 

B0051 000C 0000 

B0052 

B0053 000E 

B0054 

B0055 



DORG -2 
IRBSOC BYTE 
IRBEC BYTE 
* 

DORG 
IRBOC BYTE 
IRBLUN BYTE 
IRBSFL BYTE 
IRFBSY EQU 



IRFERR 
IRFEOF 
IRFVNT 
IRBDIA 



EQU 1 

EQU 2 

EQU 3 

EQU 7 



IRBUFL BYTE 
IRFINT EQU 



IRFRPY 

IRFVAL 

IRFKFG 

IRFBFI 

IRFRES 

IRFOS 

IRFACC 

IRFACl 

IRFACM 

IRFOSF 

IRFLOC 

IRFMDS 

IRFTIH 

IRFIMO 

IRFOWN 

IRFEXR 

IRFBAD 

IRFWPM 

IRFRTY 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



EQU >0018 
EQU 4 
5 
5 
5 
5 
6 
6 
7 
7 
7 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



IRBDBA DATA 
IRBICC DATA 
IRBOCC DATA 
IRBRN1 DATA 
OLDBFR EQU 8 



IRBRN2 DATA 
* 

PRBSIZ EQU $ 

* 

* DIRECT DISK EQUATES 



SUPERVISOR OPCODE 
ERROR CODE 



SUB OPCODE 

LUNO 

SYSTEM FLAGS 

BUSY 

ERROR 

END OF FILE 

EVENT CHAR 

DIAGNOSTIC EXTENSION TO PRB 
USER FLAGS 

INITIATE REQUEST 

REPLY REQUESTED 

READ WITH VALIDATION 

KEY SPECIFIES FLAG 

BUFFERED FORMAT INFO 

RESERVED 

HEAD OFFSET 

ACCESS PRIVILEGES (2 BITS) 

ACCESS PRIVILEGES (2ND BIT) 
ACCESS PRIV. BIT MASK 

HEAD OFFSET FORWARD 

LOCK/UNLOCK 

MASTER DO NOT SUSPEND 

TRANSFER INHIBIT 

IMMEDIATE OPEN FOR TPD DSR 

OWNERSHIP LEVEL 

EXTENDED USER FLAGS 

BLANK ADJ/SET EVENT MODE 

WORD PROCESSING MODE 

NO RETRIES 
DATA BUFFER ADDRESS 
RECORD LENGTH 
CHARACTER COUNT 
RECORD # PART 1 
ON-LINE DIAG I/O BUFFER 
1 = AVAILABLE 
= NO AVAILABLE 
RECORD # PART 2 



(TRACK/ADU) 
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DSSPTSR - 

B0056 

B0057 

B0058 

B0059 

B0060 

B0061 

B0062 

B0063 

B0064 

B0065 

B0066 

B0067 

B0068 

B0069 

B0070 

B0071 

B0072 

B0073 

B0074 

B0075 
B0076 
B0077 
B0078 
B0079 
B0080 
B0081 
B0082 

B0083 OOOE 
B0084 000F 
B0085 0010 
B0086 0011 
B0087 0012 
B0088 0013 
B0089 
B0090 
B0091 0000 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
DX10 - TSR SECTION - PDT WORKSPACE 



PAGE 000 5 



000A PRBTRK 

000C PRBSCT 

000C PRBBPS 

000C PRBLTA 



000A 
000A 
000C 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
000A 
OOOB 
000C 
000D 
OOOE 
000P 
00 
00 
00 
00 
00 
00 

0014 



EQU IRBRN1 

EQU IRBRN2 

EQU IRBRN2 

EQU IRBRN2 

CALL BLOCK EXTENSION 



IRBRPY 

IRBVTA 

IRBXFL 

IRFCSF 

IRFNTN 

IRFFKR 

IRFGRA 

IRFEBA 

IRFTER 

IRFBP 

IRFRDB 

IRFCIF 

IRFFC 

IRFIF 

IRFRFF 

IRFECO 

IRFVRQ 

IRFVER 

IRFWBP 

IRBFCH 

IRBEVT 

IRBCRO 

IRBCCO 

IRBFRO 

IRBFCO 



EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

BYTE 

BYTE 

BYTE 

BYTE 

BYTE 

BYTE 



IRBRN1 

IRBRN1 

IRBRN2 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 



[ TRACK # ] [ ADU # ] 

[ (SCT/RCD)/SCT #] [SCT OFFSET] 
BYTES/SECTOR (VAR SECT LENGTH 
LOG TRACK ADDR (WRITE FORMAT) 



REPLY BLOCK ADDRESS 

VALIDATION TABLE ADDRESS 

EXTENDED USER FLAGS 

CURSOR START OF FIELD DEF 

INTENSITY 

BLINKING CURSOR (FLICKER) 

GRAPHICS DISPLAY (CHAR LT >2 0) 

8-BIT ASCII 

ENABLE TASK EDIT CARR CONTROL 

BEEP 

RIGHT DISPLAY EDGE BOUNDARY 

CURSOR IN-FIELD DEF 

FILL CHAR DEFINED 

INITIALIZE FIELD 

REMAIN IF FIELD IS FULL 

NO ECHO 

CHAR VALIDATION REQUIRED 

CHAR FIELD IS IN ERROR 

WARNING BEEP 
FILL CHARACTER 
EVENT CHARACTER 
CURSOR POSITION ROW 
CURSOR POSITION COLUMN 
FIELD DEFINITION ROW 
FIELD DEFINITION COLUMN 



IRBSIZ EQU $ 
RORG 
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DSSPTSR SDSMAC 
DSSPTSR - DX10 - 

0116 
C0001 
C0002 
C0003 
C0004 
C0005 
C0006 
C0007 
C0008 

C0009 004A 
C0010 0000 
C0011 FFB6 
C0012 FFB6 
C0013 
C0014 
C0015 
C0016 
C0017 
C0018 

C0019 FFF8 
CO 020 FFFA 
C0021 FFFC 
C0022 FFFE 
C0023 FFFF 
C0024 

C0025 FFB8 
C0026 FFBA 
C0027 FFBC 0000 
CO 02 8 FFBE 
C0029 
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3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
TSR SECTION - PDT WORKSPACE 

COPY DSC. SYSTEM. TABLES. DSRPDT 
************************************************************ 



C0030 

C0031 

C0032 

C0033 

C0034 

C0035 

C0036 

C0037 

CO 038 FFCO 

C0039 

C0040 

C0041 

C0042 

C0043 

C0044 

C0045 

C0046 



PHYSICAL DEVICE TABLE 



(PDT) 06/18/80 



POINTED TO BY R4 IN DEVICE SERVICE ROUTINES 
PSIZ MUST BE THE SIZE OF THE PDT „ e/a , 

RTS 3.1 - ADDED EXTENDED EDIT FLAGS FOR DSR911 4/25/81 



* 
* 
* 
* 
* 

********************************************* 
PSIZ EQU 74 PDT SIZE 

PDTSIZ EQU 

DORG PDTSIZ -PSIZ 
PDTLNK BSS 2 FORWARD LINKAGE TO NEXT PDT 

* THERE IS AN EXPANSION BLOCK BEFORE THE NEXT PDT. 

* TO REFERENCE IT USE THE VALUE IN PDTLNK PLUS 

* ONE OF THE FOLLOWING OFFSETS. WHEN PDTLNK IS 

* ZERO (DS01) USE THE VALUE IN PDTLST (GLOBAL 

* VARIBLE IN ROOT) . 



PDTRC EQU -8 

PDTWC EQU -6 

PDTMC EQU -4 

PDTRTY EQU -2 

PDTLUN EQU -1 



0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
000A 

0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 

C0047 FFC2 0000 

C0048 FFC4 

C0049 FFC6 

C0050 FFC8 

COO 51 FFCA 

C0052 FFCC 

COO 53 FFCE 

C0054 FFDO 

C0055 FFD2 

C0056 FFD4 0000 

C0057 FFD6 0000 

C0058 FFD8 0000 

COO 59 FFDA FFBA 



PDTMAP 

PDTRO 

PDTPRB 

PDTDSF 

DSFASG 

DSFBSY 

DSFINT 

DSFKLL 

DSFCLS 

DSFREN 

DSFEOR 

DSFJIS 

DSFWPM 

PDTDTF 

DTFFIL 

DTFTIL 

DTFTIM 

DTFPRI 

DTFKSB 

DTFCOM 

DTFSYD 

DTFEXT 

PDTDIB 

PDTR5 

PDTR6 

PDTR7 

PDTR8 

PDTR9 

PDTR10 

PDTRll 

PDTCRU 

PDTR13 

PDTR14 

PDTR15 

PDT$ 



BSS 2 
BSS 2 
DATA $-$ 
BSS 2 



EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

BSS 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 




1 
2 
3 
4 
5 
6 
7 

10 

2 



1 

2 

3 

4 

5 

6 

7 



DATA PDTLNK+PSIZ 

BSS 2 

BSS 2 

BSS 2 

BSS 2 

BSS 2 

BSS 2 

BSS 2 

BSS 2 

DATA $-$ 

DATA $-$ 

DATA $-$ 

DATA PDTRO 



NUMBER OF READS 
NUMBER OF WRITES 
NUMBER OF OTHERS 
NUMBER OF RETRIES 
NUMBER OF LUNOS ASSIGNED 

POINTER TO DSR MAP FILE 
RO - DSR SCRATCH 
Rl - QUEUED PRB ADDRESS 
R2 - DEVICE STATUS FLAGS 

ASSIGNED 

BUSY 

KILL I/O IN PROGRESS 

KILL TASK IN PROGRESS 

CLOSE OUT 

REENTER-ME 

END- RECORD 

JISCII FLAG(KATAKANA) 

WORD PROCESSING MODE 
R3 - DEVICE TYPE FLAGS 

FILE ORIENTED 

TILINE DEVICE 

ENABLE TIME-OUT 

PRIVILEGED DEVICE 

TERMINAL WITH A KSB 

COMM DEVICE 
SYSTEM DISK 

EXPANSION BLOCK PRESENT 
R4 - DEVICE INFO BLOCK ADDRESS 
R5 - DSR SCRATCH 
R6 - DSR SCRATCH 
R7 - DSR SCRATCH 
R8 - DSR SCRATCH 
R9 - DSR SCRATCH 
R10 - DSR SCRATCH 
Rll - DSR SCRATCH 
R12 - CRU OR TILINE ADDRESS 
R13 - SAVED WP 
R14 - SAVED PC 
R15 - SAVED ST 
PDTRO ADDRESS 
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DSSPTSR - 
CO 060 FFDC 
CO 061 FFDE 
C0062 FFDF 
C0063 
C0064 
C0065 
C0066 
C0067 
C0068 
C0069 
C0070 

CO 071 FFEO 
C0072 FFE4 
C0073 FFE6 
C0074 FFE8 
C0075 FFEA 
C0076 FFEC 
C0077 FFEE 
C0078 FFF8 
C0079 FFFA 
CO 080 FFFC 
C0081 FFFE 
C0082 
C0083 0000 



SDSMAC 3.6.0 


83.111 


DX10 - 


TSR SECTION - 




PDTDSR 


BSS 


2 




PDTERR 


BSS 


1 




PDTFLG 


BSS 


1 


0008 


DFGPRB 


EQU 


8 


0009 


DFGJAR 


EQU 


9 


OOOA 


DFGJAT 


EQU 


10 


OOOB 


DFGSTA 

* 


EQU 


11 


OOOE 


* 
DFGOPF 


EQU 


14 


000F 


DFGRTY 


EQU 


15 




PDTNAM 


BSS 


4 




PDTSL1 


BSS 


2 




PDTSL2 


BSS 


2 




PDTBUF 


BSS 


2 




PDTBLN 


BSS 


2 




PDTINT 


BSS 


2 




PDTDVQ 


BSS 


10 




PDTTMl 


BSS 


2 




PDTTM2 


BSS 


2 




PDTSRB 


BSS 


2 




PDTFQL 


BSS 


2 



13:16:24 FRIDAY, MAY 06, 1983. 
PDT WORKSPACE p AGE 0007 

DSR ADDRESS 

SAVED ERROR CODE 

DEVICE FLAGS 

USE PRB IN LOG MESSAGE 

J I SCI I RECEIVE MODE FLAG 

JISCII TRANSMIT MODE FLAG 

DEVICE STATE (TWO BITS) 

ONLINE =» , OFFLINE ■ 1 
DIAGNOSTIC ■ 2, UNDEFINED = 3 

OPERATION FAILED 

NO RETRIES DESIRED 

DEVICE NAME 

RESERVED FOR SYSTEM LOG 

RESERVED FOR SYSTEM LOG 

CRU BUFFER ADDRESS 

CRU BUFFER LENGTH 

DSR INTERRUPT ADDRESS 

DEVICE QUEUE ANCHOR 

TIME-OUT COUNT 1 

TIME-OUT COUNT 2 

FAST REENTER-ME QUEUE LINK 



RORG 
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DSSPTSR 


SDSMAC 3.6.0 


83.111 - 13:16:24 


FRIDAY, 


MAY 06, 1983. 


DSSPTSR - DX10 - 


TSR SECTION 


- PDT WORKSPACE 


PAGE 001 


0117 








COPY 


DSC. SYSTEM. 


. TABLES. KSB 


D0001 






********************************************************** 


D0002 






* KEYBOARD 


STATUS BLOCK 


(KSB) 02/09/77 


D0003 






********************************************************** 


D0004 


0000 






DORG 









D0005 


0000 


0020 


KSBLDT 


DATA 


KSBLDO 


RO 


- STATION LDT ADDRESS 


D0006 


0002 




KSBQOC 


BSS 


2 


Rl 


- QUEUE OUTPUT COUNT 


D0007 


0004 




KSBQIP 


BSS 


2 


R2 


- QUEUE INPUT POINTER 


D0008 


0006 




KSBQOP 


BSS 


2 


R3 


- QUEUE OUTPUT POINTER 


D0009 


0008 




KSBQEP 


BSS 


2 


R4 


- QUEUE END POINTER 


D0010 


000A 


0000 


KSBEBF 


DATA 





R5 


- EVENT CHARACTER BUFFER 


D0011 


OOOC 




KSBPL 


BSS 


1 


R6 


- KSB FLAGS 


D0012 




0000 


KSBCHM 


EQU 







CHARACTER MODE 


D0013 




0001 


KSBCIE 


EQU 


1 




COMMAND INTERP ENABLE 


D0014 




0002 


KSBRCM 


EQU 


2 




RECORD MODE 


D0015 




0003 


KSBCIB 


EQU 


3 




COMMAND INTERP BID 


D0016 




0004 


KSBICP 


EQU 


4 




COMMAND INTERP ACTIVE 


D0017 




0005 


KSBSET 


EQU 


5 




COMMAND I/O HOLD 


D001S 




0006 


KSBKIO 


EQU 


6 




COMMAND I/O ABORT 


D0019 




0007 


KSBBRK 


EQU 


7 




DEACTIVATE BREAK KEY 


D0020 


000D 




KSBSN 


BSS 


1 




- STATION NUMBER 


D0021 


OOOE 




KSBR7 


BSS 


2 


R7 


- SCRATCH 


D0022 


0010 


0000 


KSBTSB 


DATA 


$-$ 


R8 


- TSB ADDRESS 


D0023 




0010 


KSBVTA 


EQU 


KSBTSB 




VALIDATION TABLE ADDRESS 


D0024 


0012 




KSBR9 


BSS 


2 


R9 


- SCRATCH 


D0025 


0014 




KSBR10 


BSS 


2 


RIO 


- SCRATCH 


D0026 


0016 




KSBRll 


BSS 


2 


Rll 


- SCRATCH 


D0027 


0018 




KSBCRU 


BSS 


2 


R12 


- CRU BASE 


D0028 


00 1A 


0000 


KSBR13 


DATA 


$-$ 


R13 


- SAVED WP 


D0029 


001C 


0000 


KSBR14 


DATA 


$-$ 


R14 


- SAVED PC 


D0030 


001E 


0000 


KSBR15 


DATA 


$-$ 


R15 


- SAVED ST 


D0031 


0020 


0000 


KSBLDO 


DATA 







PDT ADDRESS (PDTLNK) 


D0032 


0022 


00 


KSBLD2 


BYTE 







LUNO 


D0033 


0023 


00 


KSBLD3 


BYTE 







IN IT I/O COUNT 


D0034 


0024 




KSBLD4 


BSS 


2 




LDT FLAGS 


D0035 


0026 




KSBLD6 


BSS 


2 




LDT LINK 


D0036 


0028 


0000 


KSBLD8 


DATA 


$-$ 




TSB ADDRESS 


D0037 


002A 


0000 


KSBLCK 


DATA 







LOCK COUNT 


D0038 




002C 


KSBSIZ 


EQU 


$-KSBLDT 






D0039 


0000 






RORG 









Figure 5-22. Example DSRs (Sheet 20 of 60) 
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DSSPTSR 
DSSPTSR 

0118 
E0002 
E0003 
E0004 
E0005 
E0006 
E0007 
E0008 
E0009 
E0010 
E0011 
E0012 
E0013 
E0014 
E0015 
E0016 
E0017 
E0018 
E0019 
E0020 
E0021 
E0022 
E0023 
E0099 
E0100 
E0101 
E0102 
E0103 
E0104 
E0105 
E0106 
E0107 
E0108 
E0109 
E0110 
EOlll 
E0112 
E0113 
E0114 
E0115 
E0116 
E0117 
E0118 
E0119 
E0120 
E0121 
E0122 
E0123 
E0124 
E0125 
E0126 
E0127 
E0128 
E0129 
E0130 
E0131 
E0132 
E0133 
E0134 
E0135 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DX10 - TSR SECTION - PDT WORKSPACE 

COPY DSC. SYSTEM. TABLES. AJMPMAC 



PAGE 000 9 



************************************************************ 



TITLE: ASYNC MUX JUMP TABLE 

REVISION: 25 JAN 1983 ORIGINAL 

REVISION: 22 FEB 1983 ADD DIAGNOSTIC ENTRY POINTS 

REVISION: 28 FEB 1983 USE COMMON 'JMPHSR' LABEL 

REVISION: 23 MAR 1983 DROP JUMP TABLES 

COMPUTER: 990/10A 990/10 990/12 

ABSTRACT: THIS COPY MEMBER PRODUCES A TEMPLATE OR 
TABLE FOR INTERFACE BETWEEN A TSR AND HSR. THE 
TSR TABLE PRODUCES FIXED OFFSET INTO A TABLE WHOSE 
ADDRESS IS CONTAINED IN A REGISTER. THE HSR TABLE 
PRODUCES A TABLE OF BRANCH INSTRUCTIONS FOR ACCESS 
TO THE HSR SUBROUTINE MODULES. 



• 
* 

* =1 HSR SUBROUTINE ENTRIES * 

* * 
************************************************************ 



SET TT VARIABLE BEFORE TABLE COPY STATEMENT 
TT ■ TSR TEMPLATE 

= 1 HSR SUBROUTINE ENTRIES 



REF 
REF 
REF 
REF 
REF 
REF 
REF 

REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 
REF 

REF 
REF 
REF 
REF 
REF 
REF 



HRESET 

HMRST 

HSWPWR 

HNOTIF 

HOUTP4 

HOUTP7 

HTIMER 

HSTDTR 

HRTDTR 

HSTRTS 

HRTRTS 

HSTSPT 

HRTSRT 

HSTSRS 

HRTSRS 

HSTAL 

HRTAL 

HSTRS 

HRTRS 

HSTUIL 

HRTUIL 

HSTCTH 

HRTCTH 

HSTCR 

HRTCR 

HSTBIL 

HRTBIL 

HSTTB 

HRTTB 

HRDDSR 
HRDCTS 
HRDSCT 
HRDDCD 
HRDSDC 
HRDRI 



NORMAL POWER UP/RECOVERY SUBROUTINE 
DIAGNOSTIC POWER UP/RECOVERY SUBR. 
NORMAL SOFTWARE INITIALIZATION SUBR, 
HSR INTERRUPT DECODER SUBROUTINE 
HSR OUTPUT CHARACTER SUBROUTINE 
HSR OUTPUT CHARACTER SUBROUTINE 
HSR SET TIMER DURATION SUBROUTINE 



HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 
HSR 



DTR 

DTR 

RTS 

RTS 

SRTS 

SRTS 

DSRS 

DSRS 

AL 

AL 

RS 

RS 

UIL 

UIL 

CTH 

CTH 

CR 

CR 

BIL 

BIL 

TB 

TB 



HSR DSR 
HSR CTS 
HSR SCTS 
HSR DCD 
HSR SDCD 
HSR RI 



SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT. 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT . 
FUNCT . 

SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 
SIGNAL 



SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

SET 
RESET 

READ 
READ 
READ 
READ 
READ 
READ 



SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 

SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 
SUBROUTINE 



Figure 5-22. Example DSRs (Sheet 21 of 60) 
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DSSPTSR 


SDSMAC 3.6 


.0 83.111 13:16: 


24 FRIDAY, 


MAY 06, 


, 1983. 






DSSPTSR - 


■ DX10 - 


TSR 


SECTION 


- PDT WORKSPACE 








PAGE 0010 


E0136 






REF 


HRDUIL 


HSR 


UIL 


FUNCT . 


READ SUBROUTINE 


E0137 






REF 


HRDCTH 


HSR 


CTH 


FUNCT . 


READ SUBROUTINE 


E0138 






REF 


HRDCR 


HSR 


CR 


FUNCT . 


READ SUBROUTINE 


E0139 






REF 


HRDBIL 


HSR 


BIL 


FUNCT . 


READ SUBROUTINE 


E0140 






REF 


HRDTB 


HSR 


TB 


FUNCT . 


READ SUBROUTINE 


E0141 






REF 


HRDSSS 


HSR 


SSS 


FUNCT . 


READ SUBROUTINE 


E0142 




* 


















E0143 






REF 


HESDSR 


HSR 


DSR 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0144 






REF 


HDSDSR 


HSR 


DSR 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0145 






REF 


HESCTS 


HSR 


CTS 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0146 






REF 


HDSCTS 


HSR 


CTS 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0147 






REF 


HESSCT 


HSR 


SCTS 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0148 






REF 


HDSSCT 


HSR 


SCTS 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0149 






REF 


HESDCD 


HSR 


DCD 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0150 






REF 


HDSDCD 


HSR 


DCD 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0151 






REF 


HESSDC 


HSR 


SDCD 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0152 






REF 


HDSSDC 


HSR 


SDCD 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0153 






REF 


HESRI 


HSR 


RI 


SIGNAL 


CHANGE 


NOTIFY 


ENABLE 


E0154 






REF 


HDSRI 


HSR 


RI 


SIGNAL 


CHANGE 


NOTIFY 


DISABLE 


E0155 






REF 


HESTSR 


HSR 


TSRE 


FUNCT. 


CHANGE 


NOTIFY 


ENABLE 


E0156 






REF 


HDSTSR 


HSR 


TSRE 


FUNCT. 


CHANGE 


NOTIFY 


DISABLE 


E0157 




* 


















E0158 






REF 


HSPSPD 


HSR 


SET : 


BAUD RATE SUBROUTINE 




E0159 






REF 


HSPPSL 


HSR 


set : 


PARITY, 


CHAR LENGTH, I 


STOP BIT 


E0160 




* 


















E0161 






REF 


HRPSPD 


HSR 


READ 


BAUD RATE SUBROUTINE 




E0162 






REF 


HRPPSL 


HSR 


READ 


PARITY 


,CHAR LENGTH, STOP BIT 


E0163 




* 


















E0164 






REF 


HRPDAT 


HSR 


READ 


HSR MODULE ID 






E0165 






REF 


HRPTYP 


HSR 


READ 


HARDWARE INTERFACE TYPE 


E0166 






REF 


HWUART 


HSR 


TILINE UART 


WRITE ; 


SUBROUTINE 


E0167 






REF 


HRUART 


HSR 


TILINE UART 


READ SUBROUTINE 
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DSSPTSR 
DSSPTSR - 

0119 
F0001 
F0002 
F0003 
F0004 
F0005 
F0006 
F0007 

F0008 002C 
F0009 002C 
F0010 002E 
F0011 0030 
F0012 0031 
F0013 0032 
F0014 0034 
F0015 0036 
F0016 0038 
F0017 003A 
F0018 003C 
F0019 003E 
F0020 0040 
F0021 
F0022 
F0023 

F0024 0042 
F0025 0044 
F0026 0046 
F0027 0048 
F0028 004A 
F0029 004C 
F0030 004E 
F0031 0050 
F0032 0000 

0120 
G0001 
G0002 
G0003 
G0004 
G0005 
G0006 
G0007 

G0008 0000 
G0009 

G0010 0000 
G0011 
G0012 
G0013 

G0014 0020 
G0015 
G0016 
G0017 
G0018 0090 
G0019 
G0020 
G0021 
G0022 00C0 
G0023 
G0024 0000 

0130 0000 
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DX10 - TSR SECTION - PDT WORKSPACE 

COPY DSC. SYSTEM. TABLES. DSALLLEX 
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0000 
0020 
0020 
0090 
0090 
OOCO 
00C0 
0840 



********************************************************** 

* * 

* LOCAL ASYNC EXTENSION TO PDT * 

* * 

* * 

* * 
********************************************************** 

DORG KSBSIZ 

SAVE MAP BIAS 

SAVE MAP POINTER 

HSR FLAGS 

HSR CHANNEL NUMBER 

HARDWARE SOFTWARE FIFO COUNT 

HSR SCRATCH COPY 

HSR SCRATCH COPY 

HSR SCRATCH COPY 

TSR SCRATCH/SYSGEN PARAMETERS 

TSR SCRATCH/SYSGEN PARAMETERS 

TSR SCRATCH/SYSGEN PARAMETERS 

TSR SCRATCH/SYSGEN PARAMETERS 



PDXSMB BSS 
PDXSMP BSS 
PDXFLG BSS 
PDXCHN BSS 
PDXFCT BSS 
PDXCP1 BSS 
PDXCP2 BSS 
PDXCP3 BSS 
PDXCP4 BSS 
PDXCP5 BSS 
PDXCP6 BSS 

PDXCP7 BSS 
* 

* ADDITIONAL WORDS FOR TSR 
* 

PDXCP8 BSS 2 1 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCP9 BSS 2 2 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPA BSS 2 3 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPB BSS 2 4 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPC BSS 2 5 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPD BSS 2 6 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPE BSS 2 7 TSR SCRATCH/SYSGEN PARAMETERS 

PDXCPF BSS 2 8 TSR SCRATCH/SYSGEN PARAMETERS 

RORG 

COPY DSC. SYSTEM. TABLES. DSALLREX 
************************************************************* 

* 

* REMOTE DEVICE EXTENSIONS 
* 

* 

* 

************************************************************* 

DORG 

HSRBGN EQU $ HSR PORTION OF DEVICE EXTENSIONS 

BSS >20 

HSREND EQU $ 



SWFBGN EQU HSREND 

BSS >70 

SWFEND EQU $ 
* 

TSRBGN EQU SWFEND 
BSS >30 

TSREND EQU $ 
* 

SIBUFF EQU TSREND 

BSS >780 

SIEND EQU $ 
RORG 



SOFTWARE FIFO IN DEVICE EXTENT IONS 



TSR PORTION OF DEVICE EXTENSIONS 



SCREEN IMAGE BUFFER 

1920 BYTE SCREEN IMAGE BUFFER 



Figure 5-22. Example DSRs (Sheet 23 of 60) 
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0132 


JK - 


0133 




0134 




0135 




0136 




0137 




0138 




0139 




0140 




0141 




0142 




0143 




0144 




0145 




0146 




0147 




0148 




0149 


0090 


0150 


0090 


0151 


0092 


0152 


0094 


0153 


0096 


0154 


0098 


0155 


009A 


0156 


0000 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 

DX10 - TSR SECTION - PDT WORKSPACE 

* 

DBGINS $MACRO 

DATA >1000 MACRO DEBUG INSTRUCTION (S) 
$END DBGINS 
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DATA >2C40 SYSTEM DEBUG ENABLE WORD 

DATA >1000 NO-OP FOR "NORMAL" OPERATION 

DATA >10FF JUMP HERE FOR NO DEBUG SUPPORT 

XOP 15,15 DX10 SYSTEM DEBUGGER 



0001 DSRSCH EQU 1 



DSR SCHEDULE WORD 



= USE REENTER-ME 

1 = USE DSR SCHEDULE 



LONG DISTANCE PDT EXTENSIONS 



DORG TSRBGN 



RTEXT0 BSS 
RTEXT1 BSS 
RTEXT2 BSS 
RTEXT3 BSS 
RTEXT4 BSS 
RTEXT5 BSS 
RORG 



RECEIVE BREAK COUNT 
FRAMING ERROR COUNT 
PARITY ERROR COUNT 
RECEIVER OVERRUN COUNT 
"OTHER" ERROR COUNT 
ILLEGAL INTERRUPT COUNT 



Figure 5-22. Example DSRs (Sheet 24 of 60) 
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DSSPTSR 
DSSPTSR - 

0158 

0159 

0160 

0161 

0162 002C 

0163 

0164 

0165 

0166 

0167 

0168 

0169 

0170 

0171 

0172 

0173 

0174 

0175 

0176 

0177 

0178 

0179 

0180 

0181 

0182 

0183 

0184 

0185 

0186 

0187 

0188 

0189 0000 

0190 

0191 

0192 

0193 

0194 

0195 

0196 

0197 

0198 

0199 

0200 

0201 

0202 

0203 
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002C 
003A 



0001 

0003 

0004 
0005 
0006 
0007 



0009 



000C 
000D 



003C 
003E 
0040 



000B 
000C 
000D 
000E 



PDT LOCAL EXTENSIONS (AFTER THE KSB OR PSEUDO-KSB) 



PDXMAP 
VDTEXO 

TFOWIA 

* 

TFOOIA 

TFODSR 

TF0DC3 

TFOKFG 

TFOEPF 
* 

TFORRW 

* 

* 
* 

TFOCFE 

TFORES 

* 

* 
* 

VDTEX1 EQU 

VDTEX2 EQU 

VDTEX3 EQU 

RORG 
* 



DORG 

EQU 

EQU 

EQU 
EQU 
EQU 
EQU 

EQU 
EQU 
EQU 
EQU 

EQU 
EQU 
EQU 
EQU 

EQU 
EQU 
EQU 
EQU 



ERRBI 
ERRFE 
ERRPE 
ERROE 



EQU 
EQU 
EQU 
EQU 



KSBSIZ 
PDXSMB 
PDXCP4 


1 
2 
3 

4 
5 
6 
7 

8 
9 
10 

11 

12 
13 
14 
15 

PDXCP5 
PDXCP6 
PDXCP7 



11 
12 
13 
14 



1820 DEFPRM EQU >1820 



1F1F 
0002 



SPDMSK 
DSRSET 



EQU 
EQU 



>1F1F 
2 



TSR/ISR FLAG WORD 

RESERVED 

WRITE IS ACTIVE 

RESERVED 

OTHER IS ACTIVE 

XMT HOLD DUE TO DSR LOSS 

XMT HOLD DUE TO DC3 RECEPTION 

FLAG WHEN MODE CHARACTER TO BE SENT 

EXTENDED PRINT FLAG 

RESERVED 

REENTER-ME FOR WRITE 

RESERVED 

RESERVED 

CHANNEL FAILED SELF TEST 

THIS IS A POWER RECOVERY NOT REBOOT 

RESERVED 

RESERVED 

TRANSMIT/RECEIVE BAUD RATE WORD 
OPERATIONAL PARAMETERS WORD 
TOTAL ERROR COUNT 



BREAK INTERRUPT ERROR 
FRAMING ERROR 
PARITY ERROR 
OVERRUN ERROR 



DEFAULT OPERATIONAL PARAMETERS 
EVEN PARITY, 7 BIT CHARACTERS 
ONE STOP BIT 

BAUD RATE MASK 

DSR RETURNED SIGNAL STATE BIT 



Figure 5-22. Example DSRs (Sheet 25 of 60) 
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DSSPTSR SDSMAC 
DSSPTSR - DX10 - 

0205 

0206 

0207 

0208 

0209 

0210 

0211 

0212 

0213 

0214 

0215 0000 

0216 0000 

0217 0000 
0235 0000 

0239 0000 02CA' 

0240 0002 Q2BC 

0244 0004 0460 
0006 OOOC' 

0245 0008 0460 
OOOA 01F8' 

0250 
0251 
0252 

0253 OOOC 

0254 OOOC 
*0001 OOOC 1000 

0255 OOOE C2D9 

0256 0010 22E0 
0012 0018 

0257 0014 1613 

0258 0016 

0259 0016 04CB 

0260 0018 D2E1 
001A 0000 

0261 001C 1306 

0262 001E 

0263 001E 028B 
0020 1500 

0264 0022 130C 

0265 0024 

0266 0024 028B 
0026 0300 

0267 0028 1605 

0268 002A 

0269 002A D2E1 
002C 0003 

0270 002E 22E0 
0030 OOOA 

0271 0032 1304 

0272 0034 

0273 0034 020B 
0036 0707 

0274 0038 0460 
003A 01BE" 

0275 003C 

0276 003C 

0277 003C 020A 
003E 0074" 

0278 0040 06A0 
0042 0000 
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************************************************************* 



ABSTRACT : 

HANSLP- THIS IS THE MAIN ENTRY POINT INTO THE DSR. 
THE FIRST TWO WORDS OF THIS ROUTINE ARE POINTERS TO 
THE POWER UP ENTRY ROUTINE AND THE ABORT I/O ROUTINE. 
THE THIRD WORD IS THE ENTRY POINT FOR INITIAL I/O 
CALLS AND IS USED BY THE I/O SUPERVISOR. 



************************************************************* 

A13HAN 
A23HAN 
A33HAN 



DATA PWR000 
DATA ABT000 
B 9HAN000 



B 



(3REM000 



POWER RESTORE ENTRY ADDRESS 
ABORT I/O ENTRY ADDRESS 
TSR SVC ENTRY POINT 

TSR DSR SCHEDULE ENTRY POINT 



* INITIAL I/O CALL ENTRY POINT 
* 

HAN000 

DBGINS 

DATA >1000 MACRO DEBUG INSTRUCTION (S) 

MOV *R9,Rll GET TSR FLAG WORD 

COC @TF0CFE*2+MASTAB,R11 IS CHANNEL ERROR SET? 



JNE HAN010 

CLR Rll 

MOVB @IRBOC(IRB) ,R11 

JEQ HAN002 

CI Rll,>1500 

JEQ HAN010 

CI Rll,>0300 

JNE HAN005 

HAN002 MOVB @IRBUFL ( IRB) ,Rll 



NO - TAKE JUMP 

CLEAN TEST REGISTER 
GET THE SUBOPCODE 

IF SUBOPCODE - TAKE JUMP 

OPCODE 15 ? 

YES - TAKE JUMP 

OPCODE 03 ? 

NO - TAKE JUMP 

GET USER FLAG BYTE 



COC @IRFIM0*2+MASTAB,R11 IS IMMEDIATE OPEN BIT SET? 

JEQ HAN010 YES - TAKE JUMP 

HAN005 LI Rll,>0707 LOAD DEVICE ERROR CODE 

B §ERR005 



HAN010 



LI R10,HAN040 
BL 9BRSTAT 



EXIT THROUGH ERROR ROUTINE 

GET STATISTICS TABLE ADDRESS 
OPCODE DECODER 



Figure 5-22. Example DSRs (Sheet 26 of 60) 
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DSSPTSR 
DSSPTSR - 

0280 

0281 

0282 

0283 

0284 0044 

0285 0046 
0286 

0287 0048 

0288 004A 

0289 004C 

0290 004E 

0291 0050 

0292 0052 

0293 0054 

0294 0056 

0295 0058 

0296 005A 

0297 005C 

0298 005E 

0299 0060 

0300 0062 

0301 0064 

0302 0066 

0303 0068 

0304 006A 

0305 006C 

0306 006E 

0307 0070 

0308 0072 
0309 
0310 

0311 0074 

0312 0075 

0313 0076 

0314 0077 

0315 0078 

0316 0079 

0317 007A 

0318 007B 

0319 007C 

0320 007D 

0321 007E 

0322 007F 

0323 0080 

0324 0081 

0325 0082 

0326 0083 

0327 0084 

0328 0085 

0329 0086 

0330 0087 

0331 0088 

0332 0089 
0333 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
DX10 - TSR SECTION - PDT WORKSPACE 



PAGE 0015 



THE STATISTICS TABLE MUST BE MODIFIED IF THE OPCODE 
TABLE IS MODIFIED. 



0015 
01BA' 



HAN020 DATA HAN030 
DATA ILL010 



LAST OPCODE USED 

OPCODE OUT OF RANGE RETURN 



00 8A' DATA 

008A' DATA 

00A2' DATA 

00A2' DATA 

00A2' DATA 

013C' DATA 

01E6' DATA 

01E6' DATA 

01BA' DATA 

01BA' DATA 

01BA' DATA 

00A8* DATA 

00A8' DATA 

00A2' DATA 

00A2' DATA 

01E6' DATA 

01BA' DATA 

01BA' DATA 

01BA' DATA 

01B2' DATA 

01BA' DATA 

00C0-* DATA 
0015 HAN030 EQU 

FC HAN040 BYTE 

FC BYTE 

FC BYTE 

FC BYTE 

FC BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

F8 BYTE 

F8 BYTE 

FA BYTE 

FA BYTE 

FA BYTE 

FA BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

00 BYTE 

00 BYTE 



OPN010 
CLS010 
REW010 
OPN100 
REW100 
STA010 
IGN010 
IGN100 
ILL010 
ILL100 
ILL200 
WRT010 
WRT100 
REW200 
REW300 
IGN200 
ILL300 
ILL400 
ILL500 
DMP010 
ILL600 
OLD010 
($-HAN020-6)/2 

PDTMC 

PDTMC 

PDTMC 

PDTMC 

PDTMC 









PDTRC 

PDTRC 

PDTWC 

PDTWC 

PDTWC 

PDTWC 

















OPEN 

CLOSE 

CLOSE/EOF 

OPEN/REWIND 

CLOSE/UNLOAD 

READ STATUS 

FORWARD SPACE 

BACKWARD SPACE 

ILLEGAL OPCODE 

READ ASCII 

READ DIRECT 

WRITE ASCII 

WRITE DIRECT 

WRITE/EOF 

REWIND 

UNLOAD 

UNUSED 

UNUSED 

UNUSED 

DUMP STATS 

UNUSED 

OPCODE 15 



OPEN 

CLOSE 

CLOSE/EOF 

OPEN/REWIND 

CLOSE/UNLOAD 

READ STATUS 

FORWARD SPACE 

BACKWARD SPACE 

ILLEGAL OPCODE 

READ ASCII 

READ DIRECT 

WRITE ASCII 

WRITE DIRECT 

WRITE/EOF 

REWIND 

UNLOAD 

UNUSED 

UNUSED 

UNUSED 

DUMP STATS 

UNUSED 

OPCODE 15 



>00 
>01 
>02 
>03 
>04 
>05 
>06 
>07 
>08 
>09 
>0A 
>0B 
>0C 
>0D 
>0E 
>0F 
>10 
>11 
>12 
>13 
>14 
>15 



>00 
>01 
>02 
>03 
>04 
>05 
>06 
>07 
>08 
>09 
>0A 
>0B 
>0C 
>0D 
>0E 
>0F 
>10 
>11 
>12 
>13 
>14 
>15 
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LI R6,CRCR 



LOAD ADDRESS OF CR/CR 



LOAD COUNT 



OPN020 LI R8,2 

SOC @TF0OIA*2+MASTAB,*R9 SET OTHER ACTIVE 

OPN030 SOC <§TF0WIA*2+MASTAB,*R9 SET TRANSMIT ACTIVE FLAG 

SOC <§TF0RRW*2+MASTAB,*R9 SET REENTER DUE TO XMT 
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0335 008A OPN010 

0336 008A CLS010 

0337 008A 0206 
008C 04E0' 

0338 008E 

0339 008E 

0340 008E 0208 
0090 0002 

0341 0092 E660 
0094 0006 

0342 0096 E660 
0098 0002 

0343 009A E660 
009C 0012 

0344 009E 0460 
00A0 01F8* 

0345 00A2 

0346 00A2 

0347 00A2 OPN100 

0348 00A2 REW010 

0349 00A2 REW100 

0350 00A2 REW200 

0351 00A2 REW300 

0352 00A2 0206 
00A4 04E2' 

0353 00A6 10F3 

0354 00A8 

0355 00A8 

0356 00A8 
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QREMOOO 



GO PROCESS IT 



LI R6,CRFF 
JMP OPN020 



LOAD ADDRESS OF CR/FF 



Figure 5-22. Example DSRs (Sheet 28 of 60) 
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DSSPTSR 


DSSPTSR - 


0358 




0359 




0360 




0361 




0362 




0363 




0364 




0365 




0366 




0367 




0368 




0369 


00A8 


0370 


00A8 


0371 


00A8 




00AA 


0372 


00 AC 


0373 


OOAE 




OOBO 


0374 


00B2 




00B4 


0375 


00B6 


0376 


00B6 




00B8 


0377 


OOBA 




OOBC 


0378 


OOBE 


0379 


OOCO 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06 1981 
DX10 - TSR SECTION - PDT WORKSPACE ' 1983 * 

WRT010 - WRITE DIRECT ROUTINE 

WRT100 - WRITE ASCII ROUTINE (SAME AS WRITE DIREPTM 

THIS ROUTINE OPERATES IN THE PDT WORKS PAPF^n tt, a 
NORMAL WRITE, WILL JUST SET AN IcTIW FLAG AMn'rlfr 
REENTER-ME TO OUTPUT CHARACTERS? AF^ER A REVUES? 
tL C SsER ETE ' A ""^ C ° DE WILL^TURf ?HE S IRB TO 



"I:::******************************************************* 



WRT010 
WRT100 

c221 MOV @IRBOCC(IRB) ,R8 

0008 

!604 JNE WRT150 

°4 E1 CLR @IRBICC(IRB) 

0460 B ^RETURN 
01E6* 



GET XMT CHARACTER COUNT 

IF ANY - TAKE JUMP 
CLEAR XMT CURRENT COUNT 



IF NONE - EXIT 

SET XMT BUFFER ADDRESS 



C1A1 WRT150 MOV @IRBDBA (IRB) ,R6 
0004 

4660 SZC @TF0OIA*2 + MASTAB,*R9 RESET OTHER IS ACTIVE 

10EB jmp OPN030 



Figure 5-22. Example DSRs (Sheet 29 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DSSPTSR - DX10 - TSR SECTION - PDT WORKSPACE 
0381 



0382 
0383 
0384 
0385 
0386 
0387 

0388 00C0 

0389 00C0 D2E7 
00C2 PFDF 

0390 00C4 024B 
00C6 1800 

0391 00C8 028B 
OOCA 1000 

0392 OOCC 1303 

0393 OOCE 020B 
00D0 9C9C 

0394 00D2 1075 

0395 00D4 

0396 00D4 

0397 00D4 C2E1 
00D6 0004 

0398 00D8 C2DB 

0399 OODA 024B 
OODC FFOO 

0400 OODE 028B 
00E0 3100 

0401 00E2 1A6B 

0402 00E4 130B 

0403 00E6 

0404 00E6 028B 
00E8 3500 

0405 OOEA 1B67 

0406 OOEC 137C 

0407 OOEE 

0408 OOEE 028B 
OOFO 3400 

0409 00F2 131E 

0410 00F4 

0411 00F4 028B 
00F6 3200 

0412 00F8 1308 

0413 OOFA 1016 

0414 OOFC 



PAGE 0018 
************************************************************* 
* 

* OLD010 - ON LINE DIAGNOSTIC SUPPORT 

* THIS ROUTINE ALLOWS OPCODE 15 SUPPORT FOR ONLINE 



DIAGNOSTICS . 



************************************************************* 
OLD010 



OLD020 



MOVB @PDTFLG(PDT) ,Rll 

ANDI Rll,>1800 

CI Rll,>1000 

JEQ OLD020 
LI Rll,>9C9C 

JMP ERR005 

MOV @IRBDBA(IRB) ,Rll 

MOV *Rll,Rll 
ANDI R11,>FF00 



CI 


Rll,>3100 


JL 
JEQ 


ILLCDE 
OLDlOO 


CI 


Rll f >3500 


JH 
JEQ 


ILLCDE 
RETURN 


CI 


Rll,>3400 


JEQ 


OLD400 


CI 


Rll,>3200 


JEQ 
JMP 


OLD200 
OLD300 



GET PDT FLAG WORD 

LEAVE ONLY DEVICE STATE 

IN DIAGNOSTIC MODE? 

YES - TAKE JUMP 

LOAD WRONG DEVICE STATE 

EXIT 

GET OPCODE 15 BUFFER ADDRESS 

GET OPCODE 15 SUBOPCODE 
MASK OFF UNUSED BYTE 

BELOW VALID SUBOPCODES? 

YES - TAKE JUMP 

IF OPCODE >31 - TAKE JUMP 

ABOVE VALID SUBOPCODES? 

YES - TAKE JUMP 

IF OPCODE >35 - TAKE JUMP 

ABOVE VALID SUBOPCODES? 

IF OPCODE >34 - TAKE JUMP 

OPCODE >32? 

YES - TAKE JUMP 
OPCODE >33 - TAKE JUMP 



Figure 5-22. Example DSRs (Sheet 30 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DSSPTSR - DX10 - TSR SECTION - PDT WORKSPACE 

0416 * 

0417 * WRITE UART SUB-SUBOPCODE >31 

0418 * 

0419 00FC C021 OLD100 MOV 0IRBCRO (IRB) ,R0 
00FE 0010 

0420 0100 06A0 BL QHWUART 
0102 0000 

0421 0104 OlBA* DATA ILLCDE 

0422 0106 0460 OLD150 B @PWR090 
0108 03A6' 

0423 * 

0424 * READ UART SUB-SUBOPCODE >32 

0425 * 

0426 010A C021 OLD200 MOV 9IRBCRO (IRB) ,R0 
010C 0010 

042 7 010E 06A0 BL 9HRUART 

0110 0000 

0428 0112 01BA' DATA ILLCDE 

0429 0114 011C' DATA OLD250 

0430 0116 C840 MOV RO ,@IRBCRO(IRB) 
0118 0010 

0431 011A 10F5 JMP OLD150 

0432 011C 

0433 011C 0721 OLD250 SETO @IRBCRO(IRB) 
011E 0010 

LIMI 2 



PAGE 0019 



GET THE PASSED UART WORD 

CALL LOAD SUBROUTINE 

NOT SUPPORTED RETURN 
RETURN THE IRB AND EXIT 



GET THE PASSED UART WORD 

CALL READ SUBROUTINE 

NOT SUPPORTED RETURN 
FUNCTION FAILED RETURN 
STORE THE RETURNED VALUE 



B 



9PWR100 



0434 0120 0300 
0122 0002 

0435 0124 0460 
0126 03BC" 

0436 * 

0437 * 

0438 * 

0439 0128 0300 OLD300 LIMI 2 
012A 0002 

0440 012C 0460 
012E 0356' 

0441 * 

0442 * 

0443 * 

0444 0130 0300 OLD400 LIMI 2 
0132 0002 

0445 0134 06A0 BL 9HMRST 
0136 0000 

0446 0138 03BC' DATA PWRlOO 

0447 013A 10E5 JMP OLD150 

0448 013C 



NO - RETURN THE IRB 
STORE THE RETURNED VALUE 
MASK INTERRUPTS 
RETURN THE IRB WITH ERROR 



SOFTWARE POWER UP SUB-SUBOPCODE >33 

MASK INTERRUPTS 
B QPWR032 GO TO SOFTWARE POWER UP 

HARDWARE RESET SUB-SUBOPCODE >34 

MASK INTERRUPTS 

CALL RESET SUBROUTINE 

ERROR RETURN 

RETURN THE IRB AND EXIT 



Figure 5-22. Example DSRs (Sheet 31 of 60) 
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DSSPTSR 
DSSPTSR 

0450 

0451 

0452 

0453 

0454 

0455 

0456 

0457 

0458 

0459 

0460 

0461 

0462 

0463 

0464 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 

nvin _ T<?R SECTION - PDT WORKSPACE PAbb u ^f^ 

DX10 - TSR^SECTION^^^^ui^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*** 



STA010 - READ DEVICE STATUS INFORMATION 

UP TO 38 BYTES OF STATUS INFORMATION IS RETURNED 
IN THE SCB DATA BUFFER. 

************************************************************ 



2300 
2400 
0026 



013C 
013C 04CB 
013E D80B 
0140 0191' 

0465 0142 06A0 
0144 0000 

0466 0146 06CO 

0467 0148 D800 
014A 0196" 

0468 014C 0280 
014E 2300 

0469 0150 1303 

0470 0152 0280 
0154 2400 

0471 0156 1603 

0472 0158 

0473 0158 D827 
015A 0031 
015C 0191' 

0474 015E 

0475 015E C80C 
0160 0192' 

0476 0162 D827 
0164 003C 
0166 01A4' 

0477 0168 

0478 0168 C2E1 
016A 0006 

0479 016C 028B 
016E 0026 

0480 0170 1202 

0481 0172 020B 
0174 0026 

0482 0176 

0483 0176 C84B 
0178 0008 

0484 017A 1335 

0485 017C C2A1 
017E 0004 

0486 0180 0200 
0182 018C" 

0487 0184 DEB0 

0488 0186 060B 

0489 0188 16FD 

0490 018A 102D 



CI403 EQU 
CI404 EQU 
STACNT EQU 

* 

STA010 EQU 
CLR 



>2300 
>2400 
38 



$ 

Rll 
MOVB Rll,@STAll0 



BL QHRPTYP 

SWPB R0 

MOVB R0,@STA130 

CI R0,CI403 



JEQ 
CI 



STA020 
R0,CI4Q4 



JNE STA050 
STA020 MOVB QPDXCHN (PDT) , QSTA110 

STA050 MOV R12,@STA120 

MOVB VDTEXl(PDT) ,@STA140 



MOV 

CI 

JLE 
LI 



QIRBICC(IRB) ,R11 

Rll, STACNT 

STA060 
Rll, STACNT 



STA060 MOV Rll,@IRBOCC(IRB) 

JEQ RETURN 

MOV QIRBDBA(IRB) ,R10 

LI R0,STA100 

STA070 MOVB *R0+,*R10+ 

DEC Rll 

JNE STA070 

JMP RETURN 



CI 403 EQUATE 
CI 404 EQUATE 
MAX RETURN SIZE 



CLEAR REGISTER 
CLEAR PORT ID NUMBER 

CALL READ HARDWARE TYPE 

MOVE IT TO LEFT BYTE 
LOAD IT 

IS IT A CI403? 

YES - TAKE JUMP 
IS IT A CI404? 

NO - TAKE JUMP 
LOAD CHANNEL NUMBER 



LOAD CRU/TILINE ADDRESS 
LOAD SPEED CODE 

GET TRANSFER COUNT 

REQUESTED COUNT GT STACNT? 

NO - TAKE JUMP 

FORCE MAX ALLOWABLE COUNT 

LOAD RETURN COUNT 

IF NONE - RETURN 
GET BUFFER ADDRESS 

GET INFO ADDRESS 



MOVE THE BYTE 
DEC BYTE COUNT 
NO - TAKE JUMP 
EXIT 



FINISHED? 



Figure 5-22. Example DSRs (Sheet 32 of 60) 
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DSSPTSR 
DSSPTSR - 

0492 018C 

0493 

0494 018C 

0495 

0496 018C 

0497 018E 

0498 0190 

0499 0191 

0500 0192 

0501 0194 

0502 0196 

0503 0197 

0504 0198 

0505 019A 

0506 019C 

0507 019E 

0508 01A0 

0509 01A2 

0510 01A4 

0511 01A5 

0512 01A6 

0513 01A8 

0514 01AA 

0515 01AC 

0516 01AE 

0517 01B0 

0518 01B2 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 
DX10 - TSR SECTION - PDT WORKSPACE 



1983. 



PAGE 0021 



018C 

OOFF 

0000 

10 

00 

0000 

FFFF 

00 

00 

0000 

0000 

0000 

0000 

0000 

0000 

00 

00 

0000 

0000 

0000 

0000 

0000 

0000 



READ DEVICE STATUS INFORMATION 



STA100 



STA110 
STA120 

STA130 



STA140 



EQU 

DATA 

DATA 

BYTE 

BYTE 

DATA 

DATA 

BYTE 

BYTE 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

BYTE 

BYTE 

DATA 

DATA 

DATA. 

DATA 

DATA 

DATA 



$ 

>00FF 

>0000 

>10 

>00 

>0000 

>FFFF 

>00 

>00 

>0000 

>0000 

>0000 

>0000 

>0000 

>0000 

>00 

>00 

>0000 

>0000 

>0000 

>0000 

>0000 

>0000 



00 - 


01 


RESERVED 


02 - 


03 


RESERVED 


04 




DSR TYPE-DSRSPC 


05 




PORT ID NUMBER 


06 - 


07 


CRU/TILINE ADDR. 


08 - 


09 


RESERVED 


10 




HARDWARE TYPE 


11 




RESERVED 


12 - 


13 


RESERVED 


14 - 


15 


RESERVED 


16 - 


17 


RESERVED 


18 - 


19 


RESERVED 


20 - 


21 


RESERVED 


22 - 


23 


RESERVED 


24 




SPEED CODE 


25 




RESERVED 


26 - 


27 


RESERVED 


28 - 


29 


RESERVED 


30 - 


31 


RESERVED 


32 - 


33 


RESERVED 


34 - 


35 


RESERVED 


36 - 


37 


RESERVED 



Figure 5-22. Example OSRs (Sheet 33 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 

DSSPTSR - DX10 - TSR SECTION - PDT WORKSPACE PAGE 0022 

QCOQ ************************************************************* 

0521 * 

0522 * RETURN - EXIT DSR 

0523 * RESTORE PRB ADDRESS; CALLS END RECORD, AND BRANCHES 

0524 * TO IDLHSR 

0525 * 

0526 * IGNXXX - IGNORE REQUEST 

0527 * I/O CALLS THAT ARE TO BE IGNORED ENTER HERE FROM 

0528 * THE OPCODE DECODER. IT JUMPS TO RETURN 

0529 * 

0530 * DMP010 - DUMP STATISTICS BUFFERS 

531 * AN ERROR CODE IS SET TO CAUSE SYSLOG TO DUMP 

0532 * THE STATISTICS BUFFERS. 

0533 * 

534 * ILLXXX - ROUTINE TO PROCESS AN ILLEGAL I/O OPCODE. 

0535 * 

535 ************************************************************* 

0537 * 

0538 01B2 070B DMP010 SETO Rll 

0539 01B4 D9CB MOVB Rll,@PDTERR(PDT) SET DUMP ERROR CODE 
01B6 FFDE 

0540 01B8 1016 JMP RETURN 

0541 01BA 

0542 01BA ILL010 

0543 01BA ILL100 

0544 01BA ILL200 

0545 01BA ILL300 

0546 01BA ILL400 

0547 01BA ILL500 

0548 01BA ILL600 

0549 01BA ILLCDE 

0550 01BA 020B LI Rll,>0202 LOAD ERROR CODE 
01BC 0202 

0551 01BE' ERR005 EQU $ 
0559 01BE 

563 01BE F9E0 SOCB QDFGPRB+MASTAB-16 , <§PDTFLG (PDT) SET TO LOG PRB 

01C0 FFF8 

01C2 FFDF 

0567 * 



Figure 5-22. Example DSRs (Sheet 34 of 60) 
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DSSPTSR 
DSSPTSR - 

0569 01C4 

0570 01C4 

0571 01C4 
01C6 

0572 01C8 

0573 01CA 
01CC 
01CE 

0574 OlDO 
01D2 

0575 01D4 

0576 01D6 
01D8 
01DA 

0577 01DC 

0578 OlDC 

0579 OlDC 

0580 01DE 
01E0 

0581 01E2 
01E4 

0582 01E6 

0583 01E6 

0584 01E6 

0585 01E6 

0586 01E6 

0587 01E6 

0588 01E6 
01E8 

0589 01EA 

0590 01EC 
01EE 

0591 01P0 
01P2 

0592 01P4 

0593 01P4 

0594 01F6 
*0001 01F6 

0595 01P8 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DX10 - TSR SECTION - PDT WORKSPACE PAGE 00 2 3 

ERROR 
ERR010 

MOV (§PDTSRB(PDT) ,IRB RESTORE PRB ADDRESS 



C067 
FFFC 
130E 
E860 
0002 
0002 
D9CB 
FFDE 
1303 
F9E0 
0000 
FFDE 



06CB 
D84B 
FPFF 
04E7 
FFE4 



C067 
FPPC 
1304 
06A0 
0000 
06A0 
03F8' 

0380 

1000 



JEQ ERR030 jp NONE, TAKE JUMP 

SOC @IRFERR*2+MASTAB,@IRBSFL(IRB) SET IRB ERROR 



MOVB R11,PDTERR(PDT) 

JEQ ERR020 

SOCB 8BYTE02 , §PDTERR (PDT) 



LOG THE ERROR? 

NO - TAKE ERR020 JUMP 
SET OPERATION FAILED FLAG 



ERR020 



SWPB Rll 

MOVB R11,@IRBEC(IRB) 

CLR QPDTSLl(PDT) 



GET THE IRB ERROR CODE 
SET THE IRB ERROR CODE 

CLEAR THE LOG ERROR 



ERR030 

IGN010 
IGN100 
IGN200 
RETURN 



MOV @PDTSRB(PDT) , IRB RESTORE PRB ADDRESS 



EXIT 



JEQ EXIT 
BL OENDRCD 

BL (3CLN010 



RTWP 
DBGINS 
DATA >1000 



IF NONE, TAKE JUMP 
SCHEDULE EOR PROCESSOR 

CLEAN UP FOR EXIT 



MACRO DEBUG INSTRUCTION (S) 



Figure 5-22. Example DSRs (Sheet 35 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DSSPTSR - DX10 - TSR SECTION - PDT WORKSPACE 

0597 

0598 

0599 

0600 

0601 

0602 

0603 

0604 

0605 

0606 

0607 
*0001 

0608 

0609 



PAGE 0024 



0610 
0611 
0612 

0613 
0614 

0615 
0616 
0617 
0618 
0619 

0620 
0621 
0622 

0623 
0624 
0625 

0626 
0627 

0628 



01F8 

01F8 

01F8 

01F8 

01F8 

01F8 

01F8 

01FA 

01FC 

01FE 

0200 

0202 

0202 

0204 

0206 

0208 

020A 

020C 

020C 

020E 

0210 

0212 

0214 

0216 

0218 

0218 

021A 

021C 

021E 

02 IE 

0220 

0222 

0224 

0226 

0228 



1000 
C2D9 
22E0 
0002 
164C 

22E0 
0012 
1649 
4660 
0012 

0608 
D176 
C2D9 
22E0 
000E 
1308 

0285 
6100 
1A05 

0285 
7B00 
1402 
0245 
DFFF 



********************************************************** 
* 

* REMTSR - THIS IS THE ENTRY POINT USED WHEN THE 

* REENTER-ME FLAG IS SET. 
********************************************************** 

A13REM 

A23REM 

A33REM 

REM000 

DBG INS 

DATA >1000 MACRO DEBUG INSTRUCTION (S) 

MOV *R9,Rll GET FLAG WORD 

REM100 COC (§TF0WIA*2+MASTAB,Rll IS TRANSMIT ACTIVE FLAG SET? 

JNE REM400 NO - EXIT 

REM200 COC @TF0RRW*2+MASTAB,R11 REENTER DUE TO XMT? 

JNE REM400 NO - TAKE JUMP 

SZC @TF0RRW*2+MASTAB,*R9 RESET REENTER DUE TO XMT 

REM220 DEC R8 DECREMENT XMIT COUNT 

MOVB *R6+,R5 GET TRANSMIT CHARACTER 

MOV *R9,Rll GET FLAG WORD 

COC @TF0EPF*2+MASTAB,Rll EXTENDED PRINT FLAG SET? 



JEQ REM230 

CI R5 f >6100 

JL REM230 

CI R5,>7B00 

JHE REM230 
ANDI R5,#>2000 



YES - TAKE JUMP 

CHARACTER LESS THAN >61? 

YES - TAKE JUMP 

CHARACTER HIGHER THAN >7B? 

YES - TAKE JUMP 

MASK OFF LOWER CASE BIT 



Figure 5-22. Example DSRs (Sheet 36 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.1 
DSSPTSR - DX10 - TSR SECTION 

0630 0228 20A0 
022A 000E 

0631 022C 1619 

0632 022E D2E7 
0230 FFDF 

0633 0232 C145 

0634 0234 1109 

0635 0236 
0643 0236 
0647 0236 22E0 

0238 0002 

0651 023A 1612 

0652 023C 
0660 023C 
0664 023C 59E0 

023E 0002 
0240 FFDF 

0668 0242 0205 
0244 0F00 

0669 0246 1008 



11 13:16:24 FRIDAY, MAY 06, 1983. 
- PDT WORKSPACE PAGE 02 5 

REM230 COC @DSFJIS*2+MASTAB,R2 JISCII FLAG SET? 



JNE 
MOVB 

MOV 
JLT 



COC 



JNE 



REM270 NO - TAKE JUMP 

@PDTFLG(PDT) ,Rll GET PDT FLAGS 



R5,R5 
REM260 



MSB (JISCII) SET? 
YES - TAKE JUMP 



@DFGJAR*2+MASTAB-16,R11 PRINTER IN ALPHA MODE? 
REM270 YES - TAKE JUMP 



SZCB @DFGJAR*2+MASTAB-16,@PDTFLG(PDT) NO-SET ALPHA 

MODE 



LI 



LOAD SHIFT IN CODE 



0670 0248 
0671 

0679 0248 
0683 0248 22E0 
024A 0002 

0687 024C 

0688 024C 1309 

0689 024E 
0697 024E 
0701 024E F9E0 

0250 0002 
0252 FFDF 

0705 0254 

0706 0254 0205 
0256 0E00 

0707 0258 0588 

0708 025A 0606 

0709 025C E660 
025E 000C 

0710 0260 

0711 0260 06A0 
0262 0000 

0712 0264 028E" 

0713 0266 



R5,>0F00 
JMP REM265 
0248' REM260 EQU $ 

COC @DFGJAR*2+MASTAB-16,Rll PRINTER IN ALPHA MODE? 



JEQ REM270 



NO - TAKE JUMP 



SOCB @DFGJAR*2+MASTAB-16,@PDTFLG(PDT) SET KATA MODE 



LI R5,>0E00 



LOAD SHIFT OUT CODE 



REM265 INC 
DEC 
SOC 



REM270 BL 



R8 INC COUNT TO BXMIT BYTE 

R6 DECREMENT BUFFER ADDRESS 

@TF0KFG*2+MASTAB,*R9 SET "SHIFT" CHARACTER 

FLAG 



DATA 



(3HOUTP4 
REM300 



CALL OUTPUT SUBROUTINE 
FIFO FULL RETURN 



Figure 5-22. Example DSRs (Sheet 37 of 60) 
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DSSPTSR SDSMAC 
DSSPTSR - DX10 - 

0715 0266 4660 
0268 OOOC 

0716 026A C208 

0717 026C 16CF 

0718 026E 

0719 026E C067 
0270 FFFC 

0720 0272 1309 

0721 0274 

0722 0274 C2D9 

0723 0276 22E0 
0278 0006 

0724 027A 1303 

0725 027C C861 
027E 0008 
0280 0006 

0726 0282 

0727 0282 06A0 
0284 01EE* 

0728 0286 

0729 0286 06A0 
0288 03F8' 

0730 028A 0460 
028C 01F8" 

0731 028E 

0732 028E 

0733 028E C2D9 

0734 0290 22E0 
0292 OOOC 

0735 0294 1304 

0736 0296 0588 

0737 0298 0606 

0738 029A' 

0739 029A 0460 
029C 01F4' 

0740 029E 

0741 029E 
0742 

0743 029E 

0744 029E 4660 
02A0 OOOC 

0745 02A2 D2E7 
02A4 FFDF 

0746 02A6 
0754 02A6 
0758 02A6 22E0 

02A8 0002 

0762 02AA 

0763 02AA 1604 

0764 02AC 
0772 02AC 
0776 02AC 59E0 

02AE 0002 
02B0 FFDF 

0780 02B2 

0781 02B2 10F3 

0782 02B4 
0790 02B4 
0794 02B4 F9E0 

02B6 0002 



3.6.0 83.111 13:16:24 FRIDAY, 
TSR SECTION - PDT WORKSPACE 

SZC @TF0KFG*2+MASTAB, *R9 

MOV R8 , R8 
JNE REM220 

MOV §PDTSRB(PDT) , IRB 

JEQ REM290 

MOV *R9,Rll 

COC @TF0OIA*2+MASTAB,Rll 

JEQ REM280 

MOV @IRBOCC(IRB) ,@IRBICC 



MAY 06, 1983. 

PAGE 002 6 
RESET "SHIFT" CHAR XMIT 

XMIT COMPLETE? 

NO - CONTINUE OUTPUT 

RESTORE PRB ADDRESS 

IF NONE, TAKE JUMP 



REM280 BL @ENDRCD 

REM290 BL <§CLN010 
B @REM000 



GET FLAG WORD 
IS OTHER ACTIVE? 

YES - TAKE JUMP 
(IRB) UPDATE COUNT 



SCHEDULE EOR PROCESSOR 

CLEAN IT UP 

CONTINUE LOOKING FOR MORE 



REM300 MOV *R9,R11 

COC @TF0KFG*2+MASTAB,Rll 

JEQ REM500 

INC R8 

DEC R6 

REM350 EQU $ 

REM400 B @EXIT 



* MODE CHANGE CHARACTER DID 
REM500 SZC @TF0KFG*2+MASTAB,*R9 
MOVB QPDTFLG(PDT) ,Rll 



GET FLAG WORD 

"SHIFT" CHARACTER XMIT SET? 

YES - TAKE JUMP 

INCREMENT COUNT TO TRANSMIT 

DECREMENT BUFFER ADDRESS 



NOT GO OUT, RESTORE FLAGS 
RESET "SHIFT" CHAR XMIT 
GET FLAG WORD 



COC @DFGJAR*2+MASTAB-16,Rll RATA RCV SET? 



JNE REM550 



NO - TAKE JUMP 



SZCB @DFGJAR*2+MASTAB-16,@PDTFLG(PDT) SET ALPHA MODE 



JMP REM350 



REM550 SOCB @DFGJAR*2+MASTAB-16 , (3PDTFLG (PDT) SET KANA MODE 



Figure 5-22. Example DSRs (Sheet 38 of 60) 
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02B8 FFDF 

0798 02BA 10EF JMP REM350 

0799 02BC 



Figure 5-22. Example OSRs (Sheet 39 of 60) 
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0801 



0802 

0803 

0804 

0805 

0806 

0807 

0808 

0811 

0812 

0813 02BC 

0814 

0815 

0816 02BC 
*0001 02BC 1000 

0817 02BE 06A0 
02CO 03F8' 

0818 02C2 020B 
02C4 0606 

0819 02C6 0460 
02C8 01C4' 

0820 
0821 

0822 02CA 

0823 02CA 
*0001 02CA 1000 

0824 02CC C1C4 

0825 02CE C067 
02D0 FFFC 

0826 02D2 1312 

0827 02D4 

0828 02D4 020B 
02D6 0404 

0829 02D8 E860 
02DA 0002 
02DC 0002 

0830 02DE 

0831 02DE D9CB 
02E0 FFDE 

0832 02E2 1303 

0833 02E4 F9E0 
02E6 01D8' 
02E8 FFDE 

0834 02EA 

0835 02EA 

0836 02EA 06CB 

0837 02EC D84B 
02EE FFFF 

0838 02F0 04E7 
02F2 FFE4 

0839 02F4 06A0 
02F6 0284 
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**£****£******* ************************* ********************* 
* 

ABORT - I/O ABORT ROUTINE 

THE SYSTEM ENTERS HERE WHEN A DEVICE TIME OUT OCCURS 
OR A KILL I/O SVC IS RECEIVED. CURRENT OPERATION IS 
TERMINATED AND APPROPRIATE ERROR CODE IS PASSED 
TO THE SVC BLOCK. DSR IS EXITED THROUGH 'EXIT . 



*********************************************************** 

ABT000 

* NEED TO RESET CERTAIN FLAGS HERE 

* NEED TO RESET CERTAIN WORDS HERE 



DBG INS 
DATA >1000 
BL @CLN010 



LI 
B 



Rll,>0606 
@ERR010 



MACRO DEBUG INSTRUCTION (S) 

CLEAN UP ALL FLAGS AND POINTERS 

ABORT I/O ERROR 



* 
* 
PWR000 



DBGINS 
DATA >1000 
MOV R4,PDT 



MACRO DEBUG INSTRUCTION (S) 

INITIALIZE PDT FOR SUBSYSTEM 



MOV @PDTSRB(PDT) , IRB 
JEQ PWR020 
LI Rll,>0404 



IRB ACTIVE? 
NO - TAKE PWR020 JUMP 
LOAD POWER RESTORED CODE 



SOC @IRFERR*2+MASTAB,<§IRBSFL(IRB) SET ERROR IN PRB 



MOVB R11,PDTERR(PDT) 

JEQ PWR010 

SOCB @BYTE02,@PDTERR(PDT) 



LOG THE ERROR? 

NO - TAKE PWR010 JUMP 
SET OPERATION FAILED FLAG 



PWR010 



SWPB Rll 

MOVB Rll,IRBEC(IRB) 

CLR @PDTSL1(PDT) 

BL QENDRCD 



GET THE IRB ERROR CODE 
SET THE IRB ERROR CODE 

CLEAR THE LOG ERROR 

CALL END RECORD 



Figure 5-22. Example DSRs (Sheet 40 of 60) 



946250-9705 



5-113 



How to Write a Device Service Routine 



DSSPTSR 
DSSPTSR - 

0841 02F8 

0842 02F8 

0843 02F8 

0844 02FA 
02FC 

0845 02FE 

0846 0300 
0302 

0847 0304 

0848 0306 

0877 0306 

0878 0306 

0879 0308 
030A 

0880 030C 
0888 030C 
0892 030C 

030E 

0896 0310 

0897 0310 
0312 

0898 0314 

0899 0316 

0900 0318 
031A 

0901 031C 

0902 031E 

0903 031E 
0320 

0904 0322 
0324 

0905 0326 
0328 

0906 032A 
032C 

0907 032E 
0330 

0908 0332 
0334 

0909 0336 

0910 0336 
0338 

0911 033A 
033C 

0912 033E 

0913 0340 
0342 

0914 0344 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DX10 - TSR SECTION - PDT WORKSPACE 
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C147 
0225 
002C 



C9C5 
000A 

020B 
0000 
0795 
04FB 
028B 
00C0 
1AFB 

C9C4 
000E 
C9C9 
0012 
E660 
001A 
C2E7 
003C 
024B 
1F1F 
C9CB 
003C 

4660 
000E 
0767 
003E 
1302 
E660 
000E 



PWR020 
C247 MOV PDT,R9 

0229 AI R9,VDTEX0 
003A 

C2D9 MOV *R9,R11 
22E0 COC @TF0RES*2+MASTAB,Rll 
001A 
1325 JEQ PWR030 



MOVE PDT POINTER TO R9 
ADD IN OFFSET TO FLAG WORD 

GET EXTENTION WORD 1 
IS THIS POWER RESTORE? 

YES - TAKE PWR030 JUMP 



MOV PDT,R5 
AI R5 , PDXMAP 



MOV R5 , QKSBEBF ( PDT ) 

LI R11,HSRBGN 

PWR023 LDS *R5 

CLR *R11+ 

CI R11,TSREND 

JL PWR023 

MOV R4,@KSBR7(PDT) 

MOV R9,@KSBR9(PDT) 

SOC @TF0RES*2+MASTAB,*R9 

MOV @VDTEXl(PDT) ,Rll 

ANDI R11,SPDMSK 

MOV Rll , @VDTEX1 ( PDT ) 

SZC @TF0EPF*2+MASTAB,*R9 

ABS @VDTEX2(PDT) 

JEQ PWR026 

SOC @TF0EPF*2+MASTAB,*R9 



GET PDT ADDRESS 

SET LONG DISTANCE MAP FILE 



SET UP KSB REG 5 

LOAD REMOTE START ADDRESS 

SET LONG DISTANCE 

CLEAR THE WORD 

AT END OF TSR AREA 

NO - TAKE JUMP 

SET UP KSB REGISTER 7 

SET UP PDT/KSB REG 9 

SET POWER RESTORE FLAG 

GET THE BAUD RATE FROM PDT 

MASK OUT UNUSED BITS 

MOVE BAUD RATE 

CLEAR EXTENDED FLAG 

EXTENDED PRINT? 

NO - TAKE JUMP 
SET EXTENDED FLAG 



Figure 5-22. Example DSRs (Sheet 41 of 60) 
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0916 0344 

0917 0344 020B PWR026 LI Rll,DEFPRM 
0346 1820 

0918 0348 C9CB MOV Rll,@VDTEX2 (PDT) 
034A 003E 

0919 034C 04E7 CLR @VDTEX3(PDT) 
034E 0040 

0920 0350 

0921 0350 

0922 0350 06A0 PWR030 BL 9HRESET 
0352 0000 

0923 0354 03BC' DATA PWR100 

0924 0356 

0925 0356 4660 PWR032 SZC @TF0DSR*2+MASTAB,*R9 CLEAR DSR HOLD FLAG 

0358 0008 

SZC @TF0DC3*2+MASTAB,*R9 CLEAR DC3 HOLD FLAG 



PAGE 030 
LOAD UP DEFAULT PARMS 
MOVE PARITY SELECT ET AL 
CLEAR TOTAL ERROR COUNT 

CALL POWER UP ROUTINE 
POWER UP FAILURE 



0926 035A 4660 
035C 000A 

0927 035E 

0928 035E 06A0 
0360 0000 

0929 0362 03BC' 

0930 0364 

0931 0364 C027 
0366 003C 

0932 0368 06A0 
036A 0000 

0933 036C 03BC 

0934 036E 

0935 036E C027 
0370 003E 

0936 0372 06A0 
0374 0000 

0937 0376 03BC' 

0938 0378 

0939 0378 06A0 
037A 0000 

0940 037C 03BC' 

0941 037E 

0942 037E 06A0 
0380 0000 

0943 0382 03BC 

0944 0384 

0945 0384 06A0 
0386 0000 

0946 0388 038A' 

0947 038A 



BL QHSWPWR 

DATA PWR100 

MOV QVDTEXl ( PDT ) , R0 

BL QHSPSPD 

DATA PWR100 

MOV QVDTEX2 ( PDT ) , RO 

BL <§HSPPSL 

DATA PWR100 

BL OHSTDTR 

DATA PWR100 

BL QHSTRTS 

DATA PWR100 

BL QHSTSRT 

DATA PWR035 



CALL SOFTWARE POWER UP 
POWER UP FAILURE 
GET BAUD RATE 
CALL LOAD BAUD SUBROUTINE 
FUNCTION FAILED RETURN 
GET PARITY, CHAR LEN, BREAK 
CALL LOAD OPERATIONAL PARM 
FUNCTION FAILED RETURN 
CALL SET DTR SUBROUTINE 
FUNCTION FAILED RETURN 
CALL SET RTS SUBROUTINE 
FUNCTION FAILED RETURN 
CALL SET SRTS SUBROUTINE 
FUNCTION FAILED RETURN 



Figure 5-22. Example DSRs (Sheet 42 of 60) 
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DSSPTSR 
DSSPTSR - 

0949 038A 
038C 

0950 038E 

0951 0390 

0952 0392 

0953 0394 

0954 0396 

0955 0396 

0956 0396 
0398 

0957 039A 
039C 

0958 039E 

0959 03A0 

0960 03A0 
3A2 

0961 03A4 

0962 03A6 

0963 03A6 

0964 03A6 

0965 03A6 

0966 03A6 

0967 03A6 
03A8 

0968 03AA 

0969 03AC 
03AE 

0970 03B0 
03B2 

0971 03B4 

0972 03B4 
03B6 

0973 03B8 
03BA 

0974 03BC 



CALL READ DSR SIGNAL 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
DX10 - TSR SECTION - PDT WORKSPACE 
06A0 PWR035 BL @HRDDSR 
0000 

03BC DATA PWR100 
03BC' DATA PWR100 
0396' DATA PWR040 
1005 JMP PWR050 



PAGE 0031 



UNSUPPORTED FEATURE RETURN 
FUNCTION FAILED RETURN 
SIGNAL FALSE RETURN 
TRUE RETURN 



E660 PWR040 SOC @TF0DSR*2+MASTAB,*R9 SET DSR HOLD FLAG 

0008 

06A0 BL 8HSTCTH CALL SET CHANNEL XMIT HALT 

0000 

03BC" DATA PWR100. UNSUPPORTED FEATURE RETURN 



06A0 PWR050 BL QHESDSR 

0000 

03BC' DATA PWR100 



CALL ENABLE DSR CHANGE NOT IF 
UNSUPPORTED FEATURE RETURN 



PWR090 



C067 
FFFC 
1304 
04E7 
FFE4 
06A0 
02F6' 



MOV QPDTSRB(PDT) ,IRB IRB ACTIVE? 



JEQ PWR095 

CLR @PDTSL1(PDT) 

BL <§ENDRCD 



06A0 PWR095 BL @CLN010 

03F8" 

0460 B QEXIT 

01F4' 



NO - TAKE JUMP 
CLEAR THE LOG ERROR 

CALL END RECORD 



CLEAN UP FLAGS AND VECTORS 
RETURN 



Figure 5-22. Example OSRs (Sheet 43 of 60) 
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DSSPTSR SDSMAC 
DSSPTSR - DX10 - 

0976 03BC 

0977 03BC 
*0001 03BC 1000 

0978 03BE C067 
03C0 PFFC 

0979 03C2 130E 

0980 03C4 

0981 03C4 020B 
03C6 0707 

0982 03C8 E860 
03CA 0002 
03CC 0002 

0983 03CE 

0984 03CE D9CB 
03D0 PFDE 

0985 03D2 1303 

0986 03D4 P9E0 
03D6 02E6' 
03D8 FFDE 

0987 03DA 

0988 03DA 

0989 03DA 06CB 

0990 03DC D84B 
03DE FFFF 

0991 03E0 

0992 03E0 
1001 03E0 

1005 03E0 59E0 
03E2 0006 
03E4 FFDF 

1006 03E6 F9E0 
03E8 0008 
03EA FFDF 

1010 03EC 

1011 03EC E660 
03EE 0018 

1012 03F0 06A0 
03F2 0000 

1013 03F4 03A6' 

1014 03F6 10D7 

1015 03F8 



3.6.0 83.111 13:16:24 FRIDAY, MAY 06 , 1983. 

TSR SECTION - PDT WORKSPACE 

PWR100 

DBGINS 

DATA >1000 MACRO DEBUG INSTRUCTION (S) 

MOV QPDTSRB(PDT) ,IRB IRB ACTIVE? 



PAGE 00 32 



JEQ PWR150 NO - TAKE JUMP 

LI Rll,>0707 LOAD DEVICE FAIL CODE 

SOC @IRFERR*2+MASTAB,§IRBSFL(IRB) SET ERROR IN PRB 



MOVB R11,PDTERR(PDT) 



LOG THE ERROR? 



JEQ PWR110 NO - TAKE PWR110 JUMP 

SOCB @BYTE02,@PDTERR(PDT) SET OPERATION FAILED FLAG 



PWR110 



PWR150 



SWPB Rll 

MOVB Rll,IRBEC(IRB) 



GET THE IRB ERROR CODE 
SET THE IRB ERROR CODE 



SZCB @DFGSTA*2+MASTAB-16,@PDTFLG(PDT) SET OFFLINE 
SOCB @DFGSTA+1*2+MASTAB-16,@PDTFLG(PDT) SET OFFLINE 

SOC @TF0CFE*2+MASTAB r *R9 SET CHANNEL FAIL FLAG 
BL 9HSTCR CALL SET CHANNEL RESET 



DATA PWR090 
JMP PWR090 



FUNCTION FAILED RETURN 
RETURN 



Figure 5-22. Example DSRs (Sheet 44 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 

DSSPTSR - DX10 - TSR SECTION - PDT WORKSPACE PAGE 00 33 

1017 *************** ***** **************************************** 

1018 * TITLE: CLN010 - CLEAN UP SUBROUTINE * 

1019 * * 

1020 * ENTERED VIA: * 

1021 * * 

1022 * BL GCLN010 FOR CLEAN UP ROUTINE * 

1023 * * 

1024 * CREATED 10/12/82 BY CECIL GREATHOUSE * 

1025 ************************************************************ 

1026 * 

1027 03F8 04C8 CLN010 CLR R8 



1028 03FA 04C6 

1029 03FC C247 

1030 03FE 0229 
0400 003A 

1031 0402 4660 
0404 0002 

1032 0406 4660 
0408 0012 

1033 040A 4660 
040C 0006 

1034 040E 4660 
0410 000C 

1035 0412 045B 

1036 0414 

1037 0414 

1038 0414 



CLR R6 
MOV PDT , R9 
AI R9,VDTEX0 



CLEAR CHARACTER COUNT 
CLEAR BUFFER ADDRESS 
SET UP REG 9 
RESTORE FLAG WORD POINTER 



SZC @TF0WIA*2+MASTAB,*R9 RESET TRANSMIT ACTIVE FLAG 

SZC @TF0RRW*2+MASTAB,*R9 RESET REENTER XMT FLAG 

SZC @TF0OIA*2+MASTAB,*R9 RESET OTHER ACTIVE FLAG 

SZC @TF0KFG*2+MASTAB,*R9 RESET "SHIFT" CHAR XMIT 

RT RETURN 



Figure 5-22. Example DSRs (Sheet 45 of 60) 
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PAGE 00 34 
************************************************************* 
* 

* INTSLP - THIS IS THE ENTRY POINT FOR A DEVICE INTERRUPT. 

* THE INTERRUPT ROUTINE IS IN THE INTERRUPT SERVICE 

* ROUTINE SECTION OP THE TSR/ISR CODE. 
* 
* 
************************************************************* 

A13INT 



DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY/ MAY 06, 1983. 
ISRSLP - ISR SECTION - KSB WORKSPACE 

1041 

1042 

1043 

1044 

1045 

1046 

1051 

1052 

1053 0414 

1054 0414 A23INT 

1055 0414 A33INT 

1056 0414 INT000 

1057 0414 
*0001 0414 1000 

1058 0416 06A0 
0418 0000 

1059 041A 0424' 

1060 041C 04A8' 

1061 041E 04BE' 

1062 0420 0414' 

1063 0422 04D4' 

1064 0424 



DBGINS 
DATA >1000 
BL (3HNOTIF 

DATA IRC010 

DATA ITC010 

DATA ISF010 

DATA INTO 00 

DATA ISE010 



MACRO DEBUG INSTRUCTION (S) 

CALL NOTIFICATION ROUTINE 

RECEIVE INTERRUPT 
TRANSMIT INTERRUPT 
SIGNAL/FUNCTION INTERRUPT 
TIMER INTERRUPT 
ILLEGAL/INVALID INTERRUPT 



Figure 5-22. Example DSRs (Sheet 46 of 60) 
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DSSPTSR 
ISRSLP - 

1066 

1067 

1068 

1069 

1070 

1071 

1072 

1073 

1074 

1075 

1076 

1077 

1078 

1079 

1080 

1081 

1082 

1083 

1084 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
ISR SECTION - KSB WORKSPACE PAGE Q035 

************************ A************************************ 

* 

IRC010 - READ INTERRUPT RECEIVED 

CHARACTERS ARE READ INTO THE USER BUFFER WHEN 

A RECEIVE IS ACTIVE. WHEN NO RECEIVE IS ACTIVE THE 

RECEIVE CHARACTER IS TOSSED. WHEN A RECEIVE IS 

COMPLETE, THE USER BUFFER IS FULL, REENTER-ME LOGIC 

IS USED TO ACTIVATE THE TSR CODE TO RETURN THE 

IRB. 



1085 
1086 
1087 

1088 
1089 

1090 
1091 

1092 
1093 
1094 

1095 

1096 
1097 

1098 
1099 
1100 

1101 

1102 
1103 

1104 
1105 
1106 

1107 
1108 



0424 

0424 

0426 

0428 

042A 

042C 

042E 

0430 

0430 

0432 

0434 

0436 

0438 

043A 

04 3C 

043E 

0440 

0440 

0442 

0444 

0446 

0448 

044A 

044C 

044E 

0450 

0450 

0452 

0454 

0456 

0458 

045A 

045C 

045E 

0460 



C00A 
0240 
00FF 
1328 
05A7 
0040 

2020 
0016 
1605 
0795 
05A0 
0090 
4020 
0016 

2020 
0018 
1605 
0795 
05A0 
0092 
4020 
0018 

2020 
001A 
1605 
0795 
05A0 
0094 
4020 
001A 



REGISTERS USED: 

R5 - ADDRESS OF MAP FILE TO LONG DISTANCE BUFFER 

R7 - ADDRESS OF PDT 

R8 - SCRATCH 

R10 - RETURNED CHARACTER BYTE / ERROR FLAGS 

R12 - CRU/TILINE ADDRESS 



************************************************************* 



IRC010 



MOV R10,R0 
ANDI R0 f >00FF 

JEQ IRC050 

INC QVDTEX3 (PDT) 



SAVE CHARACTER 
ERROR RETURNED? 

NO - TAKE JUMP 

INC TOTAL ERROR COUNT 



COC @ERRBI*2+MASTAB,R0 BREAK INTERRUPT? 



JNE 
LDS 



IRC020 
*R5 



INC QRTEXT0 



NO -TAKE JUMP 

SET LONG DISTANCE MAP FILE 

INC RECEIVED BREAK COUNT 



SZC @ERRBI*2+MASTAB,R0 RESET BIT 



IRC020 COC @ERRFE*2+MASTAB,R0 FRAMING ERROR? 



JNE 
LDS 
INC 



IRC030 

*R5 

9RTEXT1 



NO -TAKE JUMP 

SET LONG DISTANCE MAP FILE 

INCREMENT FRAMING ERROR COUNT 



SZC @ERRFE*2+MASTAB,R0 RESET BIT 



IRC030 COC @ERRPE*2+MASTAB,R0 PARITY ERROR? 



JNE IRC035 
LDS *R5 
INC @RTEXT2 



NO -TAKE JUMP 

SET LONG DISTANCE MAP FILE 

INCREMENT PARITY ERROR COUNT 



SZC @ERRPE*2+MASTAB,R0 RESET BIT 



Figure 5-22. Example DSRs (Sheet 47 of 60) 
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1110 



1111 
1112 
1113 



1115 
1116 



1120 
1121 
1122 
1123 

1124 
1125 
1126 



2020 
001C 
1605 
0795 
05A0 



0460 
0462 
0464 
0466 
0468 
046A 0096 
1114 046C 4020 
046E 001C 
0470 
0470 C000 

1117 0472 13D0 

1118 0474 0795 

1119 0476 05A0 
0478 0098 
047A 10CC 
047C 
047C 

047C 980A 
047E 04E5' 
0480 1606 
0482 

0482 E660 
0484 000A 

1127 0486 06A0 
0488 039C 

1128 048A 0414' 

1129 048C 10C3 

1130 048E 
048E 

048E 980A 

0490 04E4' 

0492 

0494 

0494 

0496 

1136 0498 C299 

1137 049A 22A0 
049C 0008 
04 9E 13BA 
04A0 
04A0 
04A2 
04A4 
04A6 
04A8 



IRC035 COC @ERROE*2+MASTAB,R0 



PAGE 003 6 
RECEIVER OVERRUN ERROR? 



1131 
1132 

1133 
1134 
1135 



1138 
1139 
1140 



JNE 
LDS 
INC 



IRC040 

*R5 

QRTEXT3 



NO -TAKE JUMP 

SET LONG DISTANCE MAP FILE 

INCREMENT OVERRUN ERROR COUNT 



SZC @ERROE*2+MASTAB,R0 RESET BIT 



IRC040 MOV 
JEQ 
LDS 
INC 



1141 
1142 
1143 



16C0 

4660 
0OOA 



06A0 
0000 
0414' 
1000 



R0,R0 
INTO 00 

*R5 
QRTEXT4 



JMP INTO 00 



ANY "OTHER" BIT SET? 

NO - TAKE JUMP 

SET LONG DISTANCE MAP FILE 

INCREMENT OTHER ERROR COUNT 



IS RECEIVED CHARACTER A HOLD? 



IRC050 CB R10,(§DC3 
JNE IRC100 
SOC @TF0DC3*2+MASTAB r *R9 SET DC3 HOLD FLAG 



NO - TAKE JUMP 



IRC070 BL QHSTCTH 

DATA INTO 00 
JMP INTO 00 



IRC100 CB R10,@DC1 
JNE INTO 00 



CALL SET CHANNEL XMIT HALT 
UNSUPPORTED FEATURE RETURN 



RELEASE XMIT HOLD FOR DC 3? 
NO - TAKE JUMP 



SZC @TF0DC3*2+MASTAB,*R9 RESET DC3 HOLD FLAG 

MOV *R9,RlO GET MAJOR FLAG WORD 

COC @TF0DSR*2+MASTAB,R10 HOLD FOR DSR STILL ACTIVE? 



JEQ INTO 00 

IRC150 BL QHRTCTH 

DATA INTO 00 
JMP ITC010 



YES - TAKE JUMP 

CALL RESET CHANEL XMIT HALT 

UNSUPPORTED FEATURE RETURN 
FORCE XMIT INTO OPERATION 



Figure 5-22. Example DSRs (Sheet 48 of 60) 
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1145 
1146 
1147 
1148 
1149 
1150 
1151 
1152 

1153 04A8 

1154 04A8 C9E7 
04AA FPF8 
04 AC FFFA 

1155 04AE E660 
04B0 0012 

1156 04B2 

1160 04B2 C007 

1161 04B4 
1170 04B4 
1174 

1175 04B4 0220 
04B6 FFB6 

1176 04B8 0420 
04BA 0000 

1180 04BC 
1184 04BC 

1192 04BC 

1193 04BC 10AB 

1194 04BE 

1195 04BE 

1196 04BE 
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************************************************************* 
* 

* ITC010 - TRANSMIT WAS FULL AND TRANSMIT FIFO IS EMPTY 

* THIS WILL PUT THE TRANSMIT SECTION OF THE TSR 

* BACK INTO OPERATION. 
* 

************************** *********************************** 
ITC010 

MOV @PDTTM1(PDT) ,@PDTTM2 (PDT) RESET TIMEOUT COUNT 



SOC @TF0RRW*2+MASTAB,*R9 



SET REENTER XMT 
FLAG 



MOV PDT , R0 



REF TM$FST 
AI R0 r PDTLNK 

BLWP §TM$FST 



JMP INTO 00 



LOAD R0 WITH PDT ADDRESS 

POINT TO THE PDT START 
CALL DSR SCHEDULE CODE 

CHECK FOR MORE TO DO 



Figure 5-22. Example DSRs (Sheet 49 of 60) 
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How to Write a Device Service Routine 



DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
ISRSLP - ISR SECTION - KSB WORKSPACE 

1198 

1199 



PAGE 0038 
******************************************************* 
* 

* 
* 
* 
* 



ISF010 - A SIGNAL OR FUNCTION HAS CHANGED AND ITS 
STATUS REPORT WAS REQUESTED 



1200 
1201 
1202 
1203 
1204 

1205 04BE 

1206 04BE 4660 
04C0 000A 

1207 04C2 22A0 
04C4 0004 

1208 04C6 1303 

1209 04C8 E660 
04CA 0008 

1210 04CC 10DC 

1211 04CE 

1212 04CE 

1213 04CE 4660 ISF050 SZC @TF0DSR*2+MASTAB,*R9 RESET DSR HOLD FLAG 

04D0 0008 

1214 04D2 10E6 JMP IRC150 

1215 04D4 

1216 04D4 



************************************************************* 

ISF010 

SZC @TF0DC3*2+MASTAB,*R9 RESET DC3 HOLD FLAG 

COC @DSRSET*2+MASTAB,R10 IS DSR NOW SET? 

JEQ ISF050 YES - TAKE JUMP 

SOC <§TF0DSR*2+MASTAB,*R9 SET DSR HOLD FLAG 

JMP IRC070 



Figure 5-22. Example DSRs (Sheet 50 of 60) 
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DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983. 
ISRSLP - ISR SECTION - KSB WORKSPACE 

1218 

1219 

1220 

1221 

1224 

1225 04D4 

1226 04D4 05A7 
04D6 0040 

1227 04D8 0795 

1228 04DA 05A0 
04DC 009A 

1229 04DE 109A 

1230 04E0 



PAGE 0039 
****** ************************************************, lr ^, lp * vlr * 

* 

* ISE010 - SPURIOUS OR ILLEGAL INTERRUPT OCCURRED 

* 

******************************* ****************************** 
ISE010 

INC @VDTEX3(PDT) INCREMENT TOTAL ERROR COUNT 



LDS *R5 
INC 8RTEXT5 

JMP INTO 00 



SET LONG DISTANCE MAP FILE 
INCREMENT ILLEGAL INTERRUPT 

SCAN FOR MORE TO DO 



Figure 5-22. Example OSRs (Sheet 51 of 60) 



5-124 



946250-9705 



How to Write a Device Service Routine 



DSSPTSR SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 
ISRSLP - ISR SECTION - KSB WORKSPACE 



1983 
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1232 

1233 04E0 0D0D 

1234 04E2 0D0C 



1235 
1236 
1237 
1238 
1239 
1240 
1241 
NO ERRORS, 



04E4 
04E5 

04E6 
04E6 
0536 



11 
13 



CRCR 

CRFF 

DC1 

DC3 

* 

PATCH 



DATA >0D0D 
DATA >0D0C 
BYTE >11 
BYTE >13 



EVEN 
BSS 



>50 



END 
NO WARNINGS 



Figure 5-22. Example DSRs (Sheet 52 of 60) 
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How to Write a Device Service Routine 



DSSPTSR 

LABEL 
$ 



SDSMAC 3.6. 
VALUE DEFN 
0536' 



A13HAN D 
A13INT D 
A13REM D 
A23HAN D 
A23INT D 
A23REM D 
A33HAN D 
A3 3 INT D 
A33REM D 
ABT000 
BRSTAT R 
BYTE02 R 
C$DNOS 
C$DPOS 

C$DX10 

C$DX34 

C$DX5 

C$DX7 

C$NAM1 

C$NAM2 

C$NAM3 

C$NAM4 

C$OS 



C$OSV 

C$REL 

C$VER 

CI403 

CI404 

CLN010 

CLS010 

CRCR 

CRFP 

DBGINS M 

DC1 

DC3 

DEFPRM 

DFGJAR 

DFGJAT 

DFGOPF 

DFGPRB 

DFGRTY 

DFGSTA 

DMP010 

DSFASG 

DSFBSY 

DSFCLS 

DSFEOR 

DSFINT 

DSFJIS 

DSFKLL 

DSFREN 



0000' 

0414' 

01F8' 

0000' 

0414' 

01F8" 

0000' 

0414' 

01F8' 

02BC' 

0042' 

03D6' 

0004 

0004 

0003 

0005 
0001 
0002 
0044 
0058 
0031 
0030 
0003 



0003 

0035 

0033 

2300 

2400 

03F8' 

008A' 

04E0' 

04E2' 

04E4' 

04E5' 

1820 

0009 

000A 

000E 

0008 

000F 

000B 

01B2' 

0000 

0001 

0004 

0006 

0002 

0007 

0003 

0005 



0215 
1053 
0603 
0216 
1054 
0604 
0217 
1055 
0605 
0813 
0075 
0113 
A0014 
A0013 



83.111 13:16:24 FRIDAY, MAY 06, 1983. 
REFERENCES 

B0053 B0090 C0027 C0027 C0056 C0056 C0057 
C0058 D0022 D0022 D0028 D0028 D0029 D0029 
D0036 D0036 D0038 G0009 G0011 G0015 G0019 

0462 0495 0551 0671 0738 

0069 

0070 

0071 

0069 

0070 

0071 

0069 

0070 

0071 

0240 

0278 

0576 0833 0986 



PAGE 0041 
C0057 C0058 
D0030 D0030 
G0023 0309 



A0014 0003 0084 
0748 0766 0784 
A0012 A0019 A0020 0012 
0699 0756 0774 
A0015 
A0010 
A0011 
A0021 
A0022 
A0023 
A0024 

A0019 0003 0012 0084 

0645 0654 0662 

0766 0774 0784 

1163 1172 

A0020 

A0026 

A0025 

0458 

0459 

1027 

0336 

1233 

1234 

0133 

1235 

1236 

0197 

C0064 

C0065 

C0069 

C0063 

C0070 

C0066 

0538 

C0029 

C0030 

C0033 

C0035 

C0031 

C0036 

C0032 

C0034 



0219 
0850 
0111 
0792 



0553 0637 0654 

0882 0994 1163 

0237 0561 0645 

0890 1003 1172 



0673 0691 
0662 0681 



0111 
0673 
0792 



0219 0237 0553 
0681 0691 0699 
0850 0882 0890 



0561 0637 
0748 0756 
0994 1003 



0468 

0470 

0591 0729 0817 0972 

0288 

0337 

0352 

0254 0594 0607 0816 0823 0977 1057 

1132 

1123 

0917 

0647 0664 0683 0701 0758 0776 0794 



0563 



1005 1006 
0306 



0630 



Figure 5-22. Example DSRs (Sheet 53 of 60) 
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How to Write a Device Service Routine 



DSSPTSR 
LABEL 
DSFWPM 
DSRSCH 
DSRSET 
DTFCOM 
DTFEXT 
DTFFIL 
DTFKSB 
DTFPRI 
DTFSYD 
DTFTIL 
DTFTIM 
ENDRCD R 
ERR005 
ERR010 
ERR020 
ERR030 
ERRBI 
ERRFE 
ERROE 
ERROR 
ERRPE 
EXIT 
HAN000 
HAN002 
HAN005 
HAN010 
HAN020 
HAN030 
HAN040 
HDSCTS R 
HDSDCD R 
HDSDSR R 
HDSRI R 
HDSSCT R 
HDSSDC R 
HDSTSR R 
HESCTS R 
HESDCD R 
HESDSR R 
HESRI R 
HESSCT R 
HESSDC R 
HESTSR R 
HMRST R 
HNOTIF R 
HOUTP4 R 
HOUTP7 R 
HRDBIL R 
HRDCR R 
HRDCTH R 
HRDCTS R 
HRDDCD R 
HRDDSR R 
HRDRI R 
HRDSCT R 
HRDSDC R 
HRDSSS R 
HRDTB R 
HRDUIL R 
HRESET R 



SDSMAC 3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
VALUE DEFN REFERENCES 
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000A 

0001 

0002 

0005 

0007 

0000 

0004 

0003 

0006 

0001 

0002 

03B2' 

OlBE' 

01C4' 

OlDC' 

01E6' 

000B 

000C 

000E 

01C4' 

OOOD 

01F4' 

000C' 

002A' 

0034' 

003C' 

0044' 

0015 

0074' 



03A2' 



0136' 
0418' 
0262' 



038C 



0352' 



C0037 

0143 

0202 

C0044 

C0046 

C0039 

C0043 

C0042 

C0045 

C0040 

C0041 

0076 

0551 

0570 

0578 

0582 

0191 

0192 

0194 

0569 

0193 

0593 

0253 

0269 

0273 

0276 

0284 

0309 

0311 

E0146 

E0150 

E0144 

E0154 

E0148 

E0152 

E0156 

E0145 

E0149 

E0143 

E0153 

E0147 

E0151 

E0155 

E0100 

E0102 

E0103 

E0104 

E0139 

E0138 

E0137 

E0131 

E0133 

E0130 

E0135 

E0132 

E0134 

E0141 

E0140 

E0136 

E0099 



0242 
1207 



1158 1186 



0590 
0274 
0819 
0575 
0572 
1091 
1097 
1110 

1103 
0589 
0244 
0261 
0267 
0257 
0309 
0284 
0277 



0960 



0445 
1058 
0711 



0949 



0727 
0394 



1095 
1101 
1114 

1107 
0739 



0839 0970 



0973 



0264 0271 



0922 



Figure 5-22. Example DSRs (Sheet 54 of 60) 
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DSSPTSR 
LABEL 
HRPDAT R 
HRPPSL R 
HRPSPD R 
HRPTYP R 
HRTAL R 
HRTBIL R 
HRTCR R 
HRTCTH R 
HRTDTR R 
HRTRS R 
HRTRTS R 
HRTSRS R 
HRTSRT R 
HRTTB R 
HRTUIL R 
HRUART R 
HSPPSL R 
HSPSPD R 
HSRBGN 
HSREND 
HSTAL R 
HSTBIL R 
HSTCR R 
HSTCTH R 
HSTDTR R 
HSTRS R 
HSTRTS R 
HSTSRS R 
HSTSRT R 
HSTTB R 
HSTUIL R 
HSWPWR R 
HTIMER R 
HWUART R 
IGN010 
IGN100 
IGN200 
ILL010 
ILL100 
ILL200 
ILL300 
ILL400 
ILL500 
ILL600 
ILLCDE 
INTO 00 

IRB 



IRBCCO 

IRBCRO 

IRBDBA 

IRBDIA 

IRBEC 

IRBEVT 

IRBFCH 

IRBPCO 

IRBFRO 

IRBICC 



SDSMAC 
VALUE 



0144 



04A2' 



0110' 

0374' 

036A' 

0000 

0020 



03P2' 
0488' 
037A' 

0380' 

0386' 

0360' 

0102' 
01E6' 
01E6' 
01E6' 
01BA' 
01BA' 
01BA' 
01BA' 
01BA' 
01BA' 
01BA' 
01BA' 
0414' 

0001 



0011 
0010 
0004 
0007 
FPFF 
000P 
000E 
0013 
0012 
0006 



3.6.0 

DEFN 

E0164 

E0162 

E0161 

E0165 

E0116 

E0126 

E0124 

E0122 

E0108 

E0118 

E0110 

E0114 

E0112 

E0128 

E0120 

E0167 

E0159 

E0158 

G0009 

G0011 

E0115 

E0125 

E0123 

E0121 

E0107 

E0117 

E0109 

E0113 

E0111 

E0127 

E0119 

E0101 

E0105 

E0166 

0584 

0585 

0586 

0542 

0543 

0544 

0545 

0546 

0547 

0548 

0549 

1056 

0078 



B0086 
B0085 
B0044 
B0022 
B0012 
B0084 
B0083 
B0088 
B0087 
B0045 



83.111 13:16:24 FRIDAY, MAY 06, 1983 
REFERENCES 



0465 



PAGE 004 3 



1140 



0427 
0936 
0932 
0897 
G0013 



1012 
0957 
0939 

0942 

0945 

0928 

0420 
0293 
0294 
0302 
0285 
0296 
0297 
0303 
0304 
0305 
0307 
0401 
1062 
1229 
0260 
0433 
0725 

0419 
0376 



1127 



0295 



0405 0421 0428 

1117 1120 1128 1129 1133 1138 1141 1193 



0269 0371 0373 0376 
0478 0483 0485 0571 
0725 0825 0829 0837 



0397 


0419 


0426 


0430 


0573 


0580 


0588 


0719 


0967 


0978 


0982 


0990 



0426 0430 
0397 0485 



0433 



0580 0837 0990 



0373 0478 0725 



Figure 5-22. Example DSRs (Sheet 55 of 60) 
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How to Write a Device Service Routine 



DSSPTSR 

LABEL 

IRBLUN 

IRBOC 

IRBOCC 

IRBRNl 

IRBRN2 

IRBRPY 

IRBSFL 

IRBSIZ 

IRBSOC 

IRBUFL 

IRBVTA 

IRBXFL 

IRC010 

IRC020 

IRC030 

IRC035 

IRC040 

IRC050 

IRC070 

IRC100 

IRC150 

IRFAC1 

IRFACC 

IRFACM 

IRFBAD 

IRFBFI 

IRFBP 

IRFBSY 

IRFCIF 

IRFCSF 

IRFEBA 

IRFECO 

IRFEOF 

IRFERR 

IRFEXR 

IRFFC 

IRFFKR 

IRFGRA 

IRFIF 

IRFIMO 

IRFINT 

IRFKFG 

IRFLOC 

IRFMDS 

IRFNTN 

IRFOS 

IRFOSF 

IRFOWN 

IRFRDB 

IRFRES 

IRFRFF 

IRFRPY 

IRFRTY 

IRFTER 

IRFTIH 

IRFVAL 

IRFVER 

IRFVNT 

IRFVRQ 

IRFWBP 



SDSMAC 
VALUE 
0001 

0000 

0008 

000A 

000C 

000A 

0002 

0014 

FFFE 

0003 

000A 

000C 

0424' 

0440' 

0450' 

0460' 

0470' 

047C 

0486' 

048E' 

04A0' 

0004 

0003 

0018 

0007 

0001 

0006 

0000 

0008 

0000 

0004 

000C 

0002 

0001 

0006 

0009 

0002 

0003 

000A 

0005 

0000 

0001 

0005 

0005 

0001 

0003 

0004 

0006 

0007 

0002 

000B 

0001 

0007 

0005 

0005 

0001 

000E 

0003 

000D 

000F 



3.6.0 83.111 13:16:24 FRIDAY, MAY 06, 1983 
DEFN REFERENCES 
B0016 

B0015 0260 

B0046 0371 0483 0725 
B0047 B0057 B0064 B0065 
B0051 B0058 B0059 B0060 B0066 
B0064 

0829 0982 
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B0017 
B0090 
BOOH 
B0023 
B0065 
B0066 
1085 
1097 
1103 
1110 
1116 
1123 
1127 
1132 
1140 
B0032 
B0031 
B0033 
B0041 
B0028 
B0073 
B0018 
B0075 
B0067 
B0071 
B0079 
B0020 
B0019 
B0040 
B0076 
B0069 
B0070 
B0077 
B0038 
B0024 
B0027 
B0035 
B0036 
B0068 
BO 030 
B0034 
B0039 
B0074 
B0029 
B0078 
B0025 
B0043 
B0072 
B0037 
B0026 
B0081 
B0021 
B0080 
B0082 



0573 



0269 



1059 
1092 
1098 
1104 
1111 
1088 
1210 
1124 
1214 



0573 0829 0982 



0270 



Figure 5-22. Example DSRs (Sheet 56 of 60) 
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DSSPTSR 


SDSMAC 3.6.( 


3 83.111 12 


1:16:: 


LABEL 


VALUE 


DEFN 


REFERENCES 




IRFWPM 


0007 


B0042 








ISE010 


04D4" 


1225 


1063 






ISF010 


04BE" 


1205 


1061 






ISF050 


04CE" 


1213 


1208 






ITC010 


04A8" 


1153 


1060 


1142 




KSBBRK 


0007 


D0019 








KSBCHM 


0000 


D0012 








KSBCIB 


0003 


D0015 








KSBCIE 


0001 


D0013 








KSBCRU 


0018 


D0027 








KSBEBF 


000A 


D0010 


0892 






KSBFL 


oooc 


D0011 








KSBICP 


0004 


D0016 








KSBKIO 


0006 


D0018 








KSBLCK 


002A 


D0037 








KSBLDO 


0020 


D0031 


D0005 






KSBLD2 


0022 


D0032 








KSBLD3 


0023 


D0033 








KSBLD4 


0024 


D0034 








KSBLD6 


0026 


D0035 








KSBLD8 


0028 


D0036 








KSBLDT 


0000 


D0005 


D0038 






KSBQEP 


0008 


D0009 








KSBQIP 


0004 


D0007 








KSBQOC 


0002 


D0006 








RSBQOP 


0006 


D0008 








KSBR10 


0014 


D0025 








KSBR11 


0016 


D0026 








KSBR13 


00 1A 


D0028 








KSBR14 


001C 


D0029 








KSBR15 


00 IE 


D0030 








KSBR7 


000E 


D0021 


0903 






KSBR9 


0012 


D0024 


0904 






KSBRCM 


0002 


D0014 








KSBSET 


0005 


D0017 








KSBSIZ 


002C 


D0038 


F0008 


0162 




KSBSN 


000D 


O0020 








KSBTSB 


0010 


D0022 


D0023 






KSBVTA 


0010 


D0023 








MASTAB R 


0001 


0114 


0256 


0270 


0341 








0612 


0614 


0619 








0715 


0723 


0734 








0905 


0910 


0913 








1011 


1031 


1032 








1103 


1107 


1110 








1207 


1209 


1213 


OLD010 


00C0' 


0388 


0308 






OLD020 


00D4' 


0396 


0392 






OLD100 


OOFC' 


0419 


0402 






OLD150 


0106' 


0422 


0431 


0447 




OLD200 


010A" 


0426 


0412 






OLD250 


one" 


0433 


0429 






OLD300 


0128" 


0439 


0413 






OLD400 


0130" 


0444 


0409 






OLDBFR 


0008 


B0048 








OPN010 


008A" 


0335 


0287 






OPN020 


008E' 


0340 


0353 






OPN030 


0096' 


0342 


0378 






OPN100 


00A2" 


0347 


0290 






PATCH 


04E6" 


1239 
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0342 0343 0377 0563 
0630 0647 0664 0683 
0744 0758 0776 0794 



0925 0926 0956 0982 
1033 1034 1091 1095 
1114 1126 1135 1137 1155 1206 



0573 0609 

0701 0709 

0829 0846 

1005 1006 

1097 1101 



Figure 5-22. Example OSRs (Sheet 57 of 60) 
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How to Write a Device Service Routine 



DSSPTSR 


SDSMAC 3.6.0 


83.111 13: 


:16:24 


FRIDAY, MAY 


06, 1! 


983. 






LABEL 


VALUE 


DEFN REFERENCES 












PAGE UU4t> 


PDT 


0007 


0079 


0389 


0473 


0476 


0539 


0563 


0571 


0574 


0576 


0581 








0588 


0632 


0664 


0701 


0719 


0745 


0776 


0794 


0824 








0825 


0831 


0833 


0838 


0843 


0878 


0892 


0903 


0904 








0906 


0908 


0911 


0918 


0919 


0931 


0935 


0967 


0969 








0978 


0984 


0986 


1005 


1006 


1029 


1089 


1154 


1154 








1160 


1226 
















PDT$ 


FFDA 


C0059 




















PDTBLN 


FFEA 


C0075 




















PDTBUP 


FFE8 


C0074 




















PDTCRU 


FFD2 


C0055 




















PDTDIB 


FFC2 


C0047 




















PDTDSF 


FFBE 


C0028 




















PDTDSR 


FFDC 


C0060 




















PDTDTP 


FFCO 


C0038 




















PDTDVQ 


FFEE 


C0077 




















PDTERR 


FFDE 


C0061 


0539 


0574 


0576 


0831 


0833 


0984 


0986 






PDTFLG 


FFDF 


. C0062 


0389 
1006 


0563 


0632 


0664 


0701 


0745 


0776 


0794 


1005 


PDTFQL 


FFFE 


C0081 




















PDT INT 


FFEC 


C0076 




















PDTLNK 


FFB6 


C0012 < 


C0047 


1175 
















PDTLUN 


FFFF 


C0023 




















PDTMAP 


FFB8 


C0025 




















PDTMC 


FFFC 


C0021 


0311 


0312 


0313 


0314 


0315 










PDTNAM 


FFEO 


C0071 




















PDTPRB 


FFBC 


C0027 




















PDTRO 


FFBA 


C0026 


C0059 


















PDTRIO 


FFCE 


C0053 




















PDTRll 


FFDO 


C0054 




















PDTR13 


FFD4 


C0056 




















PDTR14 


FFD6 


C0057 




















PDTR15 


FFD8 


C0058 




















PDTR5 


FFC4 


C0048 




















PDTR6 


FFC6 


C0049 




















PDTR7 


FFC8 


C0050 




















PDTR8 


FFCA 


C0051 




















PDTR9 


FFCC 


C0052 




















PDTRC 


FFF8 


C0019 


0320 


0321 
















PDTRTY 


FFFE 


C0022 




















PDTSIZ 


0000 


C0010 


coon 


















PDTSL1 


FFE4 


C0072 


0581 


0838 


0969 














PDTSL2 


FFE6 


C0073 




















PDTSRB 


FFFC 


C0080 


0571 


0588 


0719 


0825 


0967 


0978 








PDTTM1 


FFF8 


C0078 


1154 


















PDTTM2 


FFFA 


C0079 


1154 


















PDTWC 


FFFA 


C0020 


0322 


0323 


0324 


0325 












PDXCHN 


0031 


F0012 


0473 


















PDXCP1 


0034 


F0014 




















PDXCP2 


0036 


F0015 




















PDXCP3 


0038 


F0016 




















PDXCP4 


003A 


F0017 


0164 


















PDXCP5 


003C 


F0018 


0186 


















PDXCP6 


003E 


F0019 


0187 


















PDXCP7 


0040 


F0020 


0188 


















PDXCP8 


0042 


F0024 




















PDXCP9 


0044 


F0025 




















PDXCPA 


0046 


F0026 




















PDXCPB 


0048 


F0027 




















PDXCPC 


004A 


F0028 




















PDXCPD 


004C 


F0029 
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DSSPTSR 

LABEL 

PDXCPE 

PDXCPP 

PDXFCT 

PDXPLG 

PDXMAP 

PDXSMB 

PDXSMP 

PRBBPS 

PRBLTA 

PRBSCT 

PRBSIZ 

PRBTRK 

PSIZ 

PWROOO 

PWR010 

PWR020 

PWR023 

PWR026 

PWR030 

PWR032 

PWR035 

PWR040 

PWR050 

PWR090 

PWR095 

PWRIOO 

PWR110 
PWR150 
RO 



Rl 

RIO 

Rll 



SDSMAC 3.6. 
VALUE DEFN 



R12 
R2 
R4 
R5 

R6 
R7 
R8 
R9 



REMOOO 
REMIOO 
REM200 
REM220 
REM230 



004E 

0050 

0032 

0030 

002C 

002C 

002E 

OOOC 

OOOC 

OOOC 

OOOE 

OOOA 

004A 

02CA' 

02EA' 

02F8' 

0314' 

0344' 

0350' 

0356' 

038A' 

0396' 

03A0' 

03A6' 

03B4' 

03BC 



83.111 13:16:24 FRIDAY, MAY 06, 
REFERENCES 



1983. 



OOOC 
0002 
0004 
0005 

0006 
0007 
0008 
0009 



01F8' 
OlFC' 
0202' 
020C' 
0228' 



F0030 

F0031 

F0013 

F0011 

0163 

F0009 

F0010 

B0059 

B0060 

B0058 

B0053 

B0057 

C0009 

0822 

0835 

0842 

0898 

0917 

0922 

0925 

0949 

0956 

0960 

0966 

0972 

0976 
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0879 
0163 



03DA' 0988 
03E0' 0992 
0000 



0001 
OOOA 
000B 



0606 
0609 
0612 
0616 
0630 



C0011 
0239 
0832 
0826 
0901 
0912 
0847 
0440 
0946 
0952 
0953 
0422 
0968 
0435 
0951 
0985 
0979 
0419 
0931 
1107 
0078 
0277 
0255 
0389 
0404 
0488 
0612 
0734 
0846 
0981 
0475 
0630 
0824 
0617 
0879 
0337 
0079 
0340 
0255 
0715 
0910 
1032 
1213 
0245 



C0047 



1013 1014 



0446 
0958 



0426 
0935 
1110 

0485 
0256 
0390 
0408 
0538 
0618 
0745 
0897 
0984 



0903 
0622 
0892 
0352 

0371 
0341 
0722 
0913 
1033 



0923 
0961 



0430 
1086 
1114 

0487 
0259 
0391 
0411 
0539 
0619 
0758 
0899 
0989 



0625 
0898 
0376 

0616 
0342 
0733 
0925 
1034 



0344 0730 



0929 0933 0937 0940 0943 0950 



0466 
1087 
1116 

1086 
0260 
0393 
0463 
0550 
0632 
0818 
0900 
0990 



0627 
1093 
0617 

0707 
0343 
0744 
0926 
1126 



0467 
1091 
1116 

1123 
0263 
0397 
0464 
0574 
0647 
0828 
0906 



0633 
1099 
0708 

0716 
0377 
0843 
0956 
1135 



0468 
1095 
1160 

1132 
0266 
0398 
0478 
0579 
0683 
0831 
0907 



0633 
1105 
0737 

0716 
0608 
0844 
1011 
1136 



0470 
1097 
1175 

1136 
0269 
0398 
0479 
0580 
0722 
0836 
0908 



0668 
1112 
1028 

0736 
0614 
0845 
1029 
1155 



0486 
1101 



1137 
0270 
0399 
0481 
0608 
0723 
0837 
0917 



0904 
1030 
1206 



0487 
1103 



1207 
0273 
0400 
0483 
0609 
0733 
0845 
0918 



0706 0878 
1118 1227 



1027 

0618 0709 



0905 
1031 
1209 



0717 

0620 0623 0626 
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DSSPTSR 


SDSMAC 


I 3.6.0 


83.111 


13: 


16:24 FRIDA 


LABEL 


VALUE 


DEFN REFERENCES 




REM260 


0248' 


0671 


0634 






REM265 


0258' 


0707 


0669 






REM270 


0260' 


0711 


0631 


0651 


0688 


REM280 


0282' 


0727 


0724 






REM290 


0286' 


0729 


0720 






REM300 


028E' 


0733 


0712 






REM350 


029A' 


0738 


0781 


0798 




REM400 


029A' 


0739 


0610 


0613 




REM500 


029E' 


0744 


0735 






REM550 


02B4' 


0794 


0763 






RETURN 


01E6' 


0587 


0374 


0406 


0484 0490 


REW010 


00A2' 


0348 


0289 






REWlOO 


00A2' 


0349 


0291 






REW200 


00A2' 


0350 


0300 






REW300 


00A2' 


0351 


0301 






RTEXTO 


0090 


0150 


1094 






RTEXT1 


0092 


0151 


1100 






RTEXT2 


0094 


0152 


1106 






RTEXT3 


0096 


0153 


1113 






RTEXT4 


0098 


0154 


1119 






RTEXT5 


009A 


0155 


1228 






SIBUFP 


ooco 


G0021 








SIEND 


0840 


G0023 








SPDMSK 


IF IF 


0201 


0907 






STAOIO 


013C 


0462 


0292 






STA020 


0158' 


0473 


0469 






STA050 


015E' 


0475 


0471 






STA060 


0176' 


0483 


0480 






STA070 


0184' 


0487 


0489 






STAIOO 


018C' 


0495 


0486 






STA110 


0191' 


0499 


0464 


0473 




STA120 


0192' 


0500 


0475 






STA130 


0196' 


0502 


0467 






STA140 


01A4' 


0510 


0476 






STACNT 


0026 


0460 


0479 


0481 




SWFBGN 


0020 


G0013 








SWFEND 


0090 


G0015 


G0017 






TPOCFE 


OOOC 


0181 


0256 


1011 




TF0DC3 


0005 


0172 


0926 


1126 


1135 1206 


TFODSR 


0004 


0171 


0925 


0956 


1137 1209 


TFOEPF 


0007 


0174 


0619 


0910 


0913 


TFOKFG 


0006 


0173 


0709 


0715 


0734 0744 


TFOOIA 


0003 


0169 


0341 


0377 


0723 1033 


TFORES 


OOOD 


0182 


0846 


0905 




TFORRW 


0009 


0177 


0343 


0612 


0614 1032 


TFOWIA 


0001 


0167 


0342 


0609 


1031 


TM$FST 


R 04BA' 


1174 


1176 






TSRBGN 


0090 


G0017 


0149 






TSREND 


OOCO 


G0019 


G0021 


0900 




TT 


0000 


0080 


E0025 






VDTEXO 


003A 


0164 


0844 


1030 




VDTEX1 


003C 


0186 


0476 


0906 


0908 0931 


VDTEX2 


003E 


0187 


0911 


0918 


0935 


VDTEX3 


0040 


0188 


0919 


1089 


1226 


WRTOIO 


00A8' 


0369 


0298 






WRTlOO 


0OA8' 


0370 


0299 






WRT150 


0OB6' 


0376 


0372 
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0540 



1213 



1034 



1155 



Figure 5-22. Example DSRs (Sheet 60 of 60) 
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How to Write a 
Supervisor Call Processor 



6.1 INTRODUCTION 

DX10 provides about 70 supervisor calls (SVCs) that perform services and provide access to data 
structures. If your environment requires additional SVCs, you can write your own SVC processor 
and include it as part of your DX10 operating system during system generation. 

6.2 HOW TO WRITE AN SVC PROCESSOR 

To add an SVC to DX10, you must design the SVC call block, build several tables, write a processor 
for the SVC, and include relevant information during system generation. 

6 21 SVC Call Block 

Because of the close relationship between the SVC call block and the SVC processor, the writer of 
the processor should also design the call block. Except for the first three bytes, you must deter- 
mine the size and content according to the SVC functions to be performed. 



Byte 



Contents 



SVC opcode. The standard SVCs use opcodes ranging from 
through >7F. Your SVCs can use any of the opcodes in the 
range > 80 through > FF. 

1 Completion code. Zero indicates a normal completion. Nonzero 
codes indicate errors or warnings. 

2 Sub-opcode. When you use sub-opcodes, you should place 
them in byte 2. When an SVC performs only one operation, you 
can use byte 2 of the SVC for any purpose. 

To allow for adaptations or extensions to an SVC and its processor, you should include a reserved 
word at the end of the defined call block. You should also make the block an even number of bytes 
beginning on a word boundary. 
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6.2.2 SVC Structure 

The SVC processing routine must DEF its own entry point and REF the system return point 
XPRT1A. However, SVC routines do not need to define a workspace, since a common workspace 
within DX10 is used for most SVCs. When the SVC routine is entered, the workspace contains: 

The entire SVC call block, or the first ten bytes (whichever is smaller) buffered in RO - R4 

The address of the calling task's map file in R5 

The address of the calling task's task status block in R8 

A DX10 internal stack pointer in R10 

The address of the SVC call block in R11, relative to the calling task's map file (in R5) 

Return information (saved workspace pointer (WP), program counter (PC),, and status 
register (ST)) in R13- R15 

Figure 6«1 shows the contents of the SVC routine workspace. The information in R10 and 
R13 - R15 must not be destroyed. SVC routines cannot issue SVCs. 

When the SVC routine finishes processing the call, it should return to the system return point, as 
shown: 

B @XPRT1A 
6.2.3 Example of User-Defined SVC 



IDT 'USRSVC 

* THIS IS AN EXAMPLE OF A USER DEFINED SVC PROCESSOR. 

* THIS ROUTINE GIVES THE CALLING TASK THE SPECIFIED 

* NEW PRIORITY. 

* 

* CALLING SEQUENCE: XOP @PRI,15 

* PRI DATA >8000 

* BYTE NEWPRI 

* 

* WHERE NEWPRI IS THE NEW PRIORITY 

************************************************* it1titititilie 

DEF USRSVC MAKE ENTRY POINT AVAILABLE 
REF XPRT1A MAKE RETURN POINT AVAILABLE 
TSBPRI EQU 8 OFFSET TO PRIORITY BYTE IN TSB 

it******************************************************* 
USRSVC CLR R12 R12=0 

LDD *R5 USE CALLING TASK'S MEMORY 

MOVB R12,@1(R11) CLEAR ERROR BYTE IN CALL BLOCK 

LDS *R5 GET THE NEW PRIORITY 

MOVB @2 (Rll) ,R9 INTO R9 

MOVB R9,@TSBPRI (R8) PUT IT IN THE CALLING TASK'S TSB 

B @XPRT1A RETURN TO CALLING TASK 

END 



6-2 Change 1 
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REGISTER 




2283075 



10 



t 1 



12 



1 3 



14 



15 



SUPERVISOR CALL BLOCK, BYTES AND 1 



SUPERVISOR CALL BLOCK , BYTES 2 AND 3 



SUPERVISOR CALL BLOCK , BYTES 4 AND 5 



SUPERVISOR CALL BLOCK , BYTES 6 AND 7 



SUPERVISOR CALL BLOCK , BYTES 8 AND 9 



SAVED MAP FILE ADDRESS 



TASK STATUS BLOCK ADDRESS 



INTERNAL STACK POINTER (DO NOT DISTURB) 



EFFECTIVE ADDRESS OF SUPERVISOR CALL BLOCK 



SAVED WORKSPACE POINTER 



SAVED PROGRAM COUNTER 



SAVED STATUS REGISTER 



Figure 6-1. SVC Routine Workspace 
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6.2.4 System Generation Requirements 

To add an SVC to the system, you must specify the following during system generation: 

• SVC parameter — The entry label of the SVC processing routine 

• FILE parameter — The pathname of the file containing the object code of the SVC 
processing routine 

• BYTE parameter — The number of bytes in the call block for the SVC being defined 

GEN990 enters the SVC entry label and call block byte length in tables in the DX10 Data Base 
module. It also includes the file which contains the SVC routine object module in the Link Editor 
control stream so that the newly defined SVCs will be incorporated in the new operating system. 
Refer to paragraph 3.4.6 for a discussion of defining an SVC during system generation., 

GEN990 assigns user-defined SVCs an SVC code, starting at >80 and incrementing by one for 
each new SVC defined. You can obtain a list of the SVCs and their codes during GEN990 by issu- 
ing a LiST command. 



6-4 946250-9705 



Privileged Supervisor Calls 



7.1 GENERAL 

Only privileged or system tasks can issue privileged supervisor calls (SVCs). Tasks are designated 
as privileged or system when they are installed. These SVCs are privileged beca use misuse of 
them can destroy the system (for instance, by irrevocably and improperly modifying the system 
disk) or hoard the system (for example, by killing other tasks). This section describes the SVCs 
what they do, and how to use them. For the examples of SVCs, assume that this .nstruct.on has 
been assembled: 

DXOP SVC, 15 DEFINE SVC AS XOP 15. 

Each call block should start on a word boundary. Error codes returned by SVC processors are 
described in the DX10 Error Reporting and Recovery Manual (Volume VI). 

NOTE 

You should not install a task on the S$SDS$ program file. If you use 
the S$SDS$ program file, your task IDs and names will be deleted 
with each new release of DX10. It is recommended that you install 
tasks in your own library. This recommendation also applies to 
installing real-time tasks, procedures, and overlays. 

7.2 INSTALL TASK (CODE > 25) 

The function of this SVC is to install an object module, supplied on a specified file or device, in a 
specified program file. 



7-1 
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BYTE 

o 



12 
14 
16 
18 

2283076 

Byte 



1 

2 



4-11 



SVC CODE 


ERROR CODE 


PFLUNO 


TASK ID 




TASK 


NAME 





FLAGS 



PROC 1 ID 



OBJLUNO 



PRIORITY 



PROC 2 ID 



FLAGS 



RESERVED (-0) 



Description 

SVC code ( = >25). 

Error code returned by DX10. 

LUNO assignment of the program file in which the task is to be 
installed. If 0, the system program file is assumed. This LUNO must be 
closed, except for the special form used by the Link Editor and other 
system utilities (see paragraph 7.2.1). 

Optional task ID. If 0, an available ID is assigned, and returned in this 
byte. Appendix B contains a list of IDs reserved for system tasks on the 
system program file. Do not assign any of these IDs to a task that you 
intend to install on the system program file. 

Task name, up to eight ASCII characters left justified with trailing 
blanks. The task name must be unique within each program file. If this 
field is binary 0, the IDT from the object module name will be used and 
returned in this field. 
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Byte Description 

12 Flags: 

Bit — Privileged task. 

Bit 1 —System task. Is mapped into system memory in addition to being 
privileged. 

Bit 2 — Memory-resident task. Must be installed on the system program 
file. Such a task remains disk resident until the next initial pro- 
gram load (I PL). 

Bit 3— Delete protected. The task cannot be deleted until the delete- 
protect bit is set to zero. 

Bit 4 — Replicative. Copies of this task may be created and may execute 
concurrently, sharing procedures. 

Bits 5- 6 —Associated with procedure 1 and 2 respectively. If 0, the pro- 
cedure is to be loaded from the same program file as the task. If 
1, the procedure is to be loaded from the system program file. 

Bit 7 — Has special usage to support the Link Editor. If 1, see paragraph 
7.2.1. Normally 0. 

13 Priority. May be 0-4 or realtime 1-127. Priorities 0-3 correspond to the 
task's execution priority level and are fixed, while priority 4 indicates that 
the priority level is to be dynamically managed by the operating system. 
The highest priority level is 0, while 3 is the lowest. Operating systems 
tasks are assigned priority and 1. Critical system tasks are assigned the 
priority of 0. Priority should be considered reserved for operating sys- 
tem use exclusively. Real-time priorities 1-127 logically fall between 
priority and 1 and are indicated by setting the most significant bit of the 
byte. 

If priority 4 is specified, the task priority is managed by the system when 
the task is bid. The task's priority is dependent upon its execution mode. 
If the parent task (that is, the task which issues the Bid Task SVC) is also 
installed with a priority of 4, then the bid task is considered to be 
executing in a foreground mode (not the same as System Command 
Interpreter (SCI) foreground). If the parent task does not have a 4 priority, 
the bid task is considered to be executing in the background mode and is 
assigned a priority of 3, in order not to degrade the response of fore- 
ground tasks. 
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Byte Description 

A foreground task initially executes at priority 1. Thereafter, each time 
the task executes a minimum number of time slices for its priority level, 
the priority level is lowered by one. When the task suspends for terminal 
input, it is reassigned priority level 1. If it suspends for any other non- 
TILINE I/O, it is assigned priority level 2 (unless the task already has a 
priority of 1). TILINE I/O does not change the priority. Whenever the task 
does terminal input, its priority becomes 1. 

14 Procedure 1 ID. A zero value indicates no procedure. 

15 Procedure 2 ID. A zero value indicates no procedure. 

16 LUNO assigned to the object file from which the task object code is to 
be read. This LUNO must not be open. 

17 Flags: 

Bit —Overflow (990/12 only). If arithmetic overflow occurs with this bit 
set to one, control will be passed to the task's end action routine. 

Bit 1 —Writable control storage (990/12 only). If the task uses a writable 
control storage area, this bit must be set to one. 

Bit 2 — Execute protected (990/12 only). If the task is to be execute pro- 
tected, this bit must be set to one. 

Bits 3 - 7 — Unused. Must be set to zero. 

18-19 Reserved. Initialize to zero. 



Sample code to install a privileged task on the system program file: 



EVEN 

BLOCK BYTE > 25 SVC CODE FOR INSTALL TASK 

BYTE RESERVED FOR RETURNED ERROR CODE 

BYTE PUT THIS TASK ON THE SYSTEM FILE 

BYTE >83 ASSIGN ID > 83 TO THIS TASK 

TEXT 'MYTASK' TASK NAME 

BYTE >88 MAKETHISTASK PRIVILEGED AND REPLICATABLE 

BYTE 2 PRIORITY 2 

DATA NO PROCEDURES 

BYTE >4A OBJECT FILE IS LUNO >4A 

BYTE RESERVED, INITIALIZE TOO 

DATA RESERVED, INITIALIZE TOO 



INSTAL SVC 



BLOCK 
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7.2.1 Special Form of Install 

Flag bit 7 is used to indicate that this is a special install operation. The bit, when set, indicates 
that the image for the program segment has already been written to the program file. This form of 
the Install SVC is used by the Link Editor in image mode to update the program file directory entry 
for the program segment. For this operation the object LUNO is not referenced. The Link Editor 
uses this SVC in conjunction with SVC >37 (used to get space on the program file). The program 
file should be opened for exclusive write access privileges before executing the Install SVC. You 
must specify the following additional information for the special Install SVC: 



Byte 

18-19 



Description 



Load address. 



20-21 



Length of task root and longest overlay path. 



22-23 



Length of task root. 



7.2.2 Install Real-Time Task 

To install a task as a real-time task, the SVC must be set up the same as for INSTALL TASK except 
for the priority byte, byte 13. The first bit of byte 13 must be set to one and the remaining seven bits 
must contain a value between one and 127 inclusive. The highest real-time priority is one and the 
lowest is 127. Refer to the NOTE in paragraph 7.1. 

7.3 INSTALL PROCEDURE (CODE > 26) 

This SVC installs an object module from a given file or device (LUNO) as a procedure in a specified 
program file. Refer to the NOTE in paragraph 7.1. The install procedure SVC block is similar to the 
install task block and has the following format: 



BYTE 




1 2 
14 

16 
18 



2283077 

946250-9705 



SVC CODE 


RETURNED ERROR CODE 


PFL.UNO 


PROCEDURE ID 


PROCEDURE NAME 


FLAGS 


OBJLUNO 


RESERVED (-0) 


RESERVED (*=0) 




RESERVED (=0) 
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Byte Description 

SVC code (> 26). 

1 Error code returned by DX10. 

2 LUNO of program file on which procedure is to be installed. If 0, the sys- 
tem program file is assumed. This LUNO must not be open except for the 
special install function (see paragraph 7.2.1). 

3 Procedure ID. If 0, the system will assign an ID and return it in this byte. 

4-11 Procedure name, up to eight ASCII characters with trailing blanks. The 

procedure name must be unique in each program file. If this field is 
binary 0, the IDT name from the object module is used. 

12 Flags, which, when set, mean the following: 

Bits - 1 — Not used, must be set to 0. 

Bit 2 — Memory resident. The procedure must be installed on the system 
program file, and will not become memory resident until the sys- 
tem is rebooted. 

Bit 3 — Delete protected. The procedure cannot be deleted until this bit 
is reset. 

Bit 4— Writable control storage (990/12 only). If the procedure uses a 
writable control storage, this bit must be set to one. 

Bit 5 — Execute protected (990/12 only). If the procedure is to be execute 
protected, this bit must be set to one. 

Bit 6 —Write protected (990/12 only). If the procedure is to be write pro- 
tected, this bit must be set to one. 

Bit 7 — Normally 0. Has special system usage if 1 is to support the Link 
Editor (see paragraph 7.2.1). 

13 LUNO assigned to the file from which the object module is to be read. 
This LUNO must not be open. 

14-15 Reserved. Initialize to zero. 
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The following is sample code to install a procedure: 



BLOCK 



EVEN 
BYTE 
BYTE 
BYTE 


>26 



>AA 


BYTE 
TEXT 
BYTE 
BYTE 




'MYPROC 



>BB 



DATA 



INSTALL PROCEDURE SVC CODE 

ERROR CODE 

PUT THE PROCEDURE ON THE FILE DESIGNATED 

BYLUNOAA. 

LET THE SYSTEM ASSIGN AN ID 

PROCEDURE NAME 

NO SPECIAL FLAGS 

THE OBJECT MODULE IS ON FILE 

DESIGNATED BY LUNO > BB 

RESERVED 



INSTAL SVC ©BLOCK INSTALL THE PROCEDURE 

A special form of the Install Procedure SVC is described in the following paragraph. 

If flag bit 7 is set, the following bytes of information must be added (see paragraph 7.2.1 for a 
complete description): 



Byte 

14-15 
16-17 
18-19 



Description 

Load address. 

Length of procedure in bytes. 

Reserved. Initialize to 0. 
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7.4 INSTALL OVERLAY (CODE > 27) 

This SVC installs an object module from a given file or device as an overlay in the specified pro- 
gram file. Refer to the NOTE in paragraph 7.1. The call block is similar to the install task call block, 
and has the following format: 



BYTE 



12 
14 

16 



SVC CODE 


RETURNED ERROR CODE 


PFLUNO 


OVERLAY ID 


OVERLAY NAME 


FLAGS 


ASSOCIATED TASK ID 


OBJLUNO 


RESERVED («0) 


RESERVED («0) 



2283078 
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Byte Description 

SVC code (> 27). 

1 Error code returned by DX1 0. 

2 LUNO of program file on which overlay is to be installed. If 0, the system 
program file is used. This LUNO must not be open except for the special 
install function. 

3 Overlay ID. If 0, the system will assign an ID and return it in this byte. 

4-11 Overlay name. The overlay name must be unique in the program file and 

can have up to eight ASCII characters with trailing blanks. If this field is 
binary 0, the IDT name from the object file is used and returned in this 
field. 

12 Flags: 

Bit — Relocatable. 

Bits 1 - 2 — Not used, must be 0. 

Bit 3 — Delete protected. The overlay cannot be deleted until this bit is 
reset. 

Bits 4 - 6 — Not used, must be 0. 

Bit 7 — Normally 0. Same as for install task and procedure. 

13 Associated task ID. If specified, the overlay must have been installed on 
the same program file as the task, and is automatically deleted when 
the task is deleted. 

14 LUNO assigned to the file from which the object module is to be read. 
This LUNO must not be open. 

15-17 Reserved. Initialize to zero. 
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The following code is an example of the call block and call: 



LAYLA 



EVEN 




BYTE 


>27 


BYTE 





BYTE 





BYTE 





TEXT 


'OLAY1' 


BYTE 


>80 


BYTE 


>83 


BYTE 


>0A 


BYTE 





DATA 






INSTALL OVERLAY CODE 

RESERVED FOR ERROR CODE 

INSTALL THIS ON THE SYSTEM FILE 

LET SYSTEM ASSIGN ID 

OVERLAY NAME 

RELOCATABLE 

ASSOCIATE WITH TASK > 83 

GET OVERLAY FROM LUNO > OA 

RESERVED 

RESERVED 



CALL 



SVC 



LAYLA INSTALL THE OVERLAY 



If flag bit 7 is set, the information added is the same as for install task or procedure (see paragraph 
7.2.1), that is: 

Byte Description 

16-17 Load address. 

18-19 Length of overlay in bytes. 

20 - 21 Reserved. Initialize to zero. 



7.5 DELETE TASK (CODE > 28) 

The Delete Task SVC deletes the task with the specified ID from the given program file. All asso- 
ciated overlays are automatically deleted. The call block is six bytes in length and has the follow- 
ing format: 





BYTE 


2 
4 


SVC CODE 


RETURNED ERROR CODE 




PFL.UNO 


ID 




FLAGS 


RESERVED (-0) 


2283079 
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Byte 


1 
2 

3 

4 



Description 



SVC code (> 28). 

Error code returned by DX10. 

LUNO assigned to the program file from which the task is to be deleted. 
Deletion of delete protected tasks is not allowed. This LUNO must not 
be open, unless flag bit 7 is set. 

ID of task to be deleted. 

Flags, which when set mean: 

Bits - 6 — Not used, must be zero. 

Bit 7 — Program file is open. 

5 Reserved. Initialize to zero. 

The following sample code deletes >83, which was installed on the program file assigned to 
LUNO>4A. 



EVEN 

DELETE BYTE >28 

BYTE 

BYTE >4A 

BYTE >83 

DATA 



SVC CODE 

RESERVED FOR ERROR CODE 

THE TASK IS ON LUNO > 4A 

THE TASK ID IS > 83 

RESERVED 



DELTSK SVC 



DELETE 



7.6 DELETE PROCEDURE (CODE > 29) 

This SVC deletes the specified procedure from the given program file. The format and contents of 
the call block are the same as for delete task (see paragraph 7.5), except that the ID in byte 3 is the 
procedure ID. 
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7.7 DELETE OVERLAY (CODE > 2A) 

This SVC deletes the specified overlay from the given program file. The format and contents of the 
call block are the same as for delete task (see paragraph 7.5), except that the ID in byte 3 is the 
overlay ID. 

7.8 KILL TASK (CODE > 33) 

The Kill Task SVC is issued by one task in order to terminate another running task. The call block 
is eight bytes and has the following format: 



BYTE 




2283080 



SVC CODE 


ERROR CODE 


RUN ID 


STATION ID 


STATE 


RESERVED (-0) 


RESERVED (-0) 



Byte 


1 
2 



4 
5-7 



Description 

SVC code (> 33). 

Error code returned by DX10. 

Run-time ID of the task to be terminated. Note that the run-time ID of a 
task may be different from the installed ID, if the task is replicatable, 
because the system chooses an ID for task replicas. 

Optional station ID. If this byte is: 

— Any running task with the specified ID will be terminated. 

>1 -> FE — The task must be associated with this station number in 
order to be terminated. 

> FF ~ Tn e task to be terminated must not be associated with a station. 
The state of the task at termination is returned in this byte. 
Reserved. Initialize to zero. 
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The following is an example of code for killing a task: 



EVEN 
KILL BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
DATA 


>33 



>83 










SVC CODE FOR KILL TASK 

ERROR CODE 

KILL TASK > 83 

KILL ANY TASK WITH RUN ID>83 

RETURN TASK > 83 STATE HERE 

RESERVED 

RESERVED 


KILTSK SVC 


©KILL 





7.9 SUSPEND AWAITING QUEUE INPUT (CODE > 24) 

This is a special SVC used by queue serving tasks. When a queue server has processed all the 
entries in its queue, it issues a code > 24 SVC to suspend itself until another entry is put on the 
queue. 

For a queue serving task this SVC serves the same purpose as an End Program SVC for a normal 
task except that the suspended queue server is not processed by the termination task; therefore, 
any task local LUNOs must be released before this SVC is issued. The queue server is not roiled 
when it suspends for queue input, but will be released from memory only when it is chosen for 
rollout by task management. The call block is one byte, which contains the SVC code: 



BYTE 




2283081 



24 



Zl 



* THIS IS SAMPLE CODE FOR A SUSPEND 

* AWAITING QUEUE INPUT SVC 

SAQI BYTE 24 THIS IS THE CALL BLOCK 



OUT SVC @SAQI THIS IS THE CALL 

7.10 READ/WRITE TSB (CODE > 2C) 

This SVC reads/writes one word of data from/to the specified task's TSB and should be used with 
extreme caution. Some fields of a TSB cannot be modified without serious impact on the operat- 
ing system. No protection is provided to prevent the use of this SVC from causing a system crash. 
Note that the use of this SVC assumes a TSB format which may be changed as new system 
requirements are implemented. 
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The logical sequence for using the Read/Write TSB SVC is as follows: 

1. Extend the time slice 

2. Read TSB 

3. Write TSB 

The call block format is as follows: 



BYTE 



SVC CODE 


ERROR CODE 


2 


FLAGS 


4 


RUN ID 


DISPLACEMENT 


6 


VALUE 


8 


RESERVED (-0) 


2283082 

Byte 



1 

2-3 


Description 

SVC code (> 2C). 

Error code returned by DX10. 

Flags: 



4 

5 
6-7 
8-9 



Bits 0-14 —Not used. Initialize to 0. 

Bit 15 — 1 for write. 
for read. 

Run-time ID of the task whose TSB is to be read/written. 

Byte offset into the TSB of the word to be read/written (should be even). 

Value of the word read/written. 

Reserved. Initialize to 0. 
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The following code is an example of a code > 2C SVC: 

* THIS ROUTINE WILL ALLOW TASK > 83 TO TAKE END ACTION AGAIN. 



RWTTSB 
SVCFLG 

VALUE 

MEMRES 
WRTFLG 
EXTEND 



EVEN 

BYTE >2C THE SVC CODE 

BYTE RESERVED FOR ERROR CODE 

DATA FLAGS = READ, 1 = WRITE 

BYTE 83 TSBOFTASK>83 

BYTE 10 THE DISPLACEMENT OF THE TASK FLAGS IN TSB 

DATA RESERVED FOR VALUE RETURNED 

DATA RESERVED 

DATA > 1000 END ACTION FLAG MASK 

DATA 1 WRITE TSB FLAG 

BYTE 9,4 EXTEND TIME SLICE 4 SYSTEM TIME UNITS 



SVC 

SVC 

SOC 

MOV 

SVC 



©EXTEND 
©RWTTSB 
© MEMRES, 
©WRTFLG, 
©RWTTSB 



EXTEND TIME SLICE 

READ THE CURRENT TSB WORD 
©VALUE RESET END ACTION 

©SVCFLG SET WRITE FLAG IN BLOCK 

WRITE THE TSB WORD 



7.1 1 READ/WRITE TASK (CODE > 2D) 

This SVC is used to read/write up to 16 words of data from/to the specified address in the desig- 
nated task. The task must be either in memory or in an unconditionally suspended state (this can 
be forced by halting the task). The call block is 40 bytes long and has the following format: 



BYTE 




2283083 



36 



38 



SVC CODE 



RUN ID 



ERROR CODE 



FLAGS 



ADDRESS 



BUFFER BLOCK 



RESERVED (-0) 
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Byte 


1 
2 



4-5 
6-37 
38-39 



Description 

SVC code (> 2D). 

Error code returned by DX10. 

Run-time ID of task to be read/written. A zero value indicates that the 
DX10 system root is to be read/written. 

Flags: 

Bit 8 — for read, 1 for write 

Bit 9 — = Task ID, 1 = System Overlay Segment ID. 

Bits 10-11 — Reserved. Initialize to zero. 

Bits 12-15 — Numberof words (a zero value specifies 16 words). 

Relative address in the specified task of the first word of the data block. 

16-word data block. 

Reserved. Initialize to zero. 



The following code is an example of a Read Task SVC: 

* THIS ROUTINE READS THE WORKSPACE OF TASK > 83, 

* ASSUMING THAT THE WORKSPACE ADDRESS IS 6, 

* AND THAT THE TASK IS MEMORY RESIDENT. 



RDTSK 



DATA 



EVEN 
BYTE 
BYTE 
BYTE 
BYTE 
DATA 

BSS 
DATA 



>2D 



>83 



6 

32 




SVC CODE 

RETURNED ERROR CODE 
READ/WRITE FROM TASK > 83 
READ 16 WORDS 
ADDRESS OF WORKSPACE 

16-WORD BUFFER 
RESERVED 



SVC 



@ RDTSK 



READ THE WORKSPACE 
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7.12 GET SYSTEM POINTER TABLE ADDRESS (CODE > 32) 

This SVC is not privileged, but it is only useful to privileged or system tasks. The SVC returns the 
memory address of a table of pointers to various system routines and data structures. The table, 
also called the overlay table, is used by disk-resident system tasks and overlays to provide run- 
time linkage with the operating system. The call block is six bytes long and has the following 
format: 





BYTE 


2 

4 




SVC 


CODE 


RETURNED ERROR CODE 




RETURNED ADDRESS 




RESERVED (=0) 


2283084 












Byte 




Description 











SVC code (> 32). 






1 




Error code returned by DX10. 






2-3 




Address return field. 






4-5 




Reserved. Initialize to zero. 



The following code is an example of the Get System Pointer Table Address SVC: 



GSPTA 



EVEN 






BYTE 


>32 


SVC CODE 


BYTE 





ERROR CODE 


DATA 





ADDRESS RETURN FIELD 


DATA 





RESERVED 



SVC @GSPTA GET SYSTEM POINTER TABLE ADDRESS 
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7.13 INITIALIZE DATE AND TIME (CODE > 3B) 

This SVC stores the date and time information given in the specified block. The 6-byte call block 
has the following format: 



BYTE 

o 

2 
4 



228308S 



SVC CODE 


ERROR CODE 


DATE/TIME BLOCK ADDRESS 


RESERVED (»0) 



The SVC code, error code, and reserved bytes have the same use as in preceding SVC descrip- 
tions. Bytes 2 and 3 contain the address of a block of data that contains the date and time. The 
data block is a 6-word block of the form: 



BYTE 




8 
10 



2283086 



YEAR 



DAY IN YEAR 



HOUR (1-24) 



MINUTE 



SECOND 



RESERVED (-0) 
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Each data word should be a binary value. The following is an example of an Initialize Data and 
Time SVC: 



IDATIM 



BLOCK 



EVEN 






BYTE 


>3B 


SVC CODE 


BYTE 





ERROR CODE 


DATA 


BLOCK 


ADDRESS OF DATA BLOCK 


DATA 





RESERVED 


DATA 


1977 


YEAR (1977) 


DATA 


84 


DAY (MARCH 25) 


DATA 


8 


HOUR (8 A.M.) 


DATA 


3 


MINUTE (8:03) 


DATA 


15 


SECOND (8:03:15) 


DATA 





RESERVED 


SVC 


©IDATIM 





7.14 DISK MANAGER (CODE > 22) 

This SVC calls the disk manager. The disk manager allocates and deallocates disk space in allo- 
catable disk units (ADUs). DX10 uses ADUs strictly for allocating and deallocating disk space. An 
ADU is an integer number of sectors on the disk, and is defined to be the smallest amount of disk 
storage which can be allocated by the disk manager. An ADU is defined such that the maximum 
number of ADUs per disk is less than 65,536 (that is, any ADU may be addressed in a 16-bit word). 
Since different disk types vary in the number of sectors (and the amount of information) they con- 
tain, ADU size varies between disks. Table 7-1 shows the ADU sizes on disks supported by DX10. 
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Table 7-1. 


Disk Descriptions 










Available 














Disk 


Space 


No. 


No. 


No. 


Sec./ 


Sec./ 


Bytes/ 


Type 


(M Bytes) 


AOUs 


Heads 


Cylinder 


Track 


ADU 


Sec. 


DS10 


4.7 


16,320 


2 


408 


20 


1 


288 


DS25 


22.3 


25,840 


5 


408 


38 


3 


288 


DS50 


44.6 


51,616 


5 


815 


38 


3 


288 


DS80 


62.7 


40,819 


5 


803 


61 


6 


256 


DS200 


169.5 


65,381 


19 


815 


38 


9 


288 


DS300 


238.3 


62,045 


19 


803 


61 


15 


256 


FD1000 


1.15 


4,004 


2 


77 


26 


1 


288 


CD1 400/32 
















Removable 


13.5 


52,544 


1 


821 


64 


1 


256 


Fixed 


13.5 


52,544 


1 


821 


64 


1 


256 


CD1 400/96 
















Removable 


13.5 


52,544 


1 


821 


64 


1 


256 


Fixed 


67.3 


43,786 


5 


821 


64 


6 


256 


WD500 


4.9 


19,200 


4 


150 


32 


1 


256 


WD500A 


17.0 


22,208 


3 


694 


32 


3 


256 


WD800-18 


18.5 


24,087 


3 


651 


37 


3 


256 


WD800-43 


43.2 


56,203 


7 


651 


37 


3 


256 


WD800A/38 


38.4 


50,105 


5 


911 


33 


3 


256 


WD800A/68 


69.2 


45,094 


9 


911 


33 


6 


256 


WD800A/114 


114.5 


49,720 


15 


904 


33 


9 


256 


WD900-138 


138.1 


59,928 


10 


805 


67 


9 


256 


WD900-138/2 


69.0 


44,946 


5 


805 


67 


6 


256 


WD900-425 


425.8 


61,600 


24 


693 


100 


27 


256 


WD900-425/2 


212.9 


55,440 


12 


693 


100 


15 


256 



When the disk manager is called via SVC code >22, the calling task is suspended and made 
eligible for rollout. The call block has the following format: 



BYTE 


2 



6 
8 

10 
12 



2283087 



SVC CODE 


ERROR CODE 


OPCODE 


RESERVED 


DISK PDT ADDRESS 


BLOCK SIZE (IN BYTES) 


MAXIMUM NUMBER OF BLOCKS 




ADU NUMBER 
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Byte Description 

SVC code (> 22). 

1 Error code returned by DX1 0. 

2 Opcode: 

— Deallocate 

1 — Allocate the whole area or fail 

2 — Allocate as much as possible 

3 — Allocate as much as possible where requested or fail 

3 Reserved. Initialize to zero. 

4-5 Physical device table (PUT) address of the disk unit on which space is to 

be allocated/deallocated. 

6-7 Size of blocks to be allocated, in bytes. Ignored for deallocation. 

8-11 Maximum number of blocks to be allocated. Bytes 8-9 ignored for 

deallocation, 10-1 1 is number of ADUs to deallocate. 

12-13 If deallocating: starting ADU of area to be released. 

If allocating: try to allocate as close to this ADU as possible; if the value 
is and the opcode is 1 or 2, the lowest area is allocated. 

Note that specifying the area to be allocated in blocks, and a block size given in bytes, makes it 
unnecessary for the caller to know the disk format. Allocations are made in terms of ADUs since 
file allocation tables within DX10 are kept in terms of ADUs. 
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In addition to the error code, the disk manager returns allocation information if the opcode was a 
1 , 2, or 3. The returned information is placed in the call block as shown: 



BYTE 

o 

2 

4 



8 
10 
1 2 



* 


ERROR CODE 


* 


* 


* 


ADUS/BLOCK 


BLOCKS/ADU 


NUMBER OF ADUS ALLOCATED 


STARTING AOU NUMBER 



2283088 



♦NOT CHANGED FROM INPUT VALUES 

Byte Description 

Not changed 

1 Error code returned by DX10. 
2-7 Not changed 

8 Number of ADUs per block (block size specified in call). Set to 1 if less 
thanl. 

9 Number of blocks per ADU. Set to if less than 1 . 
10-11 Number of ADUs allocated. 

12-13 ADU number of the first ADU in the allocated area. 
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The disk manager allocation algorithm is designed to reduce head movement and fragmentation 
of files and disk space. The priorities used when allocating disk space are: 

1 . Start at requested ADU (coalesce disk space)* 

2. Size requested* 

3. Proximity to requested ADU (reduce head movement) 

4. Lower ADU first (reduce fragmentation of disk space) 
The following is an example of a disk manager call to allocate. 





EVEN 






DSCMGR 


BYTE 


>22 


SVC CODE 


ERRCOD 


BYTE 





ERROR CODE 




BYTE 


2 


ALLOCATE AS MUCH AS POSSIBLE 




BYTE 





RESERVED 




DATA 


DPDT 


DISK PDT ADDRESS 




DATA 


128 


128-BYTE BLOCKS 


APBPA 


DATA 





NEED 64 


SIZE 


DATA 


64 


BLOCKS 


START 


DATA 





ALLOCATE AS LOW AS POSSIBLE 




SVC 


©DSCMGR 





7.15 ASSIGN SPACE ON PROGRAM RLE (CODE > 37) 

This SVC is used by the Link Editor and other system utilities. The call assigns a starting record on 
the specified program file to be loaded with a task, procedure, or overlay image. The call block has 
the following form: 



BYTE 




14 
16 



2283089 



SVC CODE 


ERROR CODE 


PFUUNO 


RESERVED (»0) 


LENGTH 


RECORD NUMBER 


RESERVED ( = 0) 



* Priority for opcodes 2, 3; reversed for opcode 1. 
946250-9705 
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Byte 


1 
2 

3 
4-5 
6-7 

8-9 



Description 

SVC code (> 37). 

Error code returned by DX10. 

LUNO assigned to the program file. The LUNO should have been 
opened with exclusive write access by the calling task. 

Reserved, initialize to zero. 

The length in bytes of the image to be written. 

Returned record number which begins the area allocated on the pro- 
gram file. 

Reserved. Initialize to zero. 



The following code is an example of the Assign Space on Program File SVC: 





EVEN 






ASOPF 


BYTE 


>37 


SVC CODE 


ERRCOD 


BYTE 





ERROR CODE 




BYTE 


PFLUN 


LUNO OF THE PROGRAM FILE 




BYTE 





RESERVED 




DATA 


100 


NEED 100 BYTES 


RECORD 


DATA 





RESERVED FOR RETURNED RECORD # 




DATA 





RESERVED 



SVC 



©ASOPF 
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7.16 INITIALIZE NEW VOLUME (CODE > 38) 

This SVC is used to initialize a new disk volume. It also installs the volume (see paragraph 7.17). 
The Initialize New Volume SVC performs the following functions: 

Formats all tracks on the disk one sector per record 

Builds track 0, sector (special volume overhead) 

Builds the bad ADU list on track 0, sector 1 

Builds the ADU availability partial bit maps which fill the remainder of track 

Builds the volume directory on the disk 

Installs the new volume by issuing an Install Volume SVC (see paragraph 7.1 7) 

The call block has the following format: 



BYTE 




4 
6 
8 

10 

12 
14 
16 

18 
20 
22 



SVC CODE 



ERROR CODE 



DISK DRIVE NAME 
(4 ASCII CHARACTERS) 



VOLUME NAME 
(8 ASCII CHARACTERS) 



NUMBER OF DIRECTORY ENTRIES 



BAD TRACK LUNO 



FLAGS 



DEFAULT PHYSICAL RECORD SIZE 



HARDWARE INTERLEAVING FACTOR 



TRACK #1 LOADER LUNO 



RESERVED («0) 



2283090 
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Byte Description 

SVC Code (> 38). 

1 Returned error code. 

2-5 Device name of disk unit (for example, DS02, DS03). 

6-13 Name of volume to be initialized. 

14-15 Number of entries to be included in the volume directory. (If equal to 

zero, > 360 is assumed.) 

16 LUNO assigned to a file which contains a list of the bad tracks for the 
new disk. The form of the list is as follows: 

HEAD CYLINDER; 

OR 

HEAD, CYLINDER; HEAD, CYLINDER; etc. 

The last entry in the list need not be followed by a semicolon. The list is 
terminated by an empty line. A zero in this field implies no list is pre- 
sent. 

17 Flags: 

> 00 Use the loader on the system disk. 

> 80 No loader will be placed on track 1 (that is, VCATALOG starts on 

track 1, sector 0). 

> CO Byte 22 identifies track 1 loader. 

18 Default physical record size used in VCATALOG for subsequent file 
creation. If the value is zero, the default physical record size is taken 
from the system generation parameter for that disk drive. 

20 Hardware interleaving factor used to format the sectors of the disk. The 

value must be N; 0< N< (number of sectors per track -2). If N =0, a 
value of 1 is assumed (this applies only to double-sided, double-density 
(DSDD) diskettes). 

22 LUNO assigned to an image file that is to be placed on track 1 . The first 

word of the file is assumed to be an entry point and is placed in track 0, 
sector 0, byte > 18. Byte 17 must contain > CO for this option. 
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The following is an example of an Initialize New Volume SVC: 



INIUT 



EVEN 




BYTE 


>38 


BYTE 




TEXT 


DS04 


TEXT 


NEWVOLbb 


DATA 


20 


BYTE 


BTLLUN 


BYTE 


>C0 


DATA 





DATA 





BYTE 


LDRLUN 


BYTE 






SVC CODE 

RETURN ERROR CODE 

DEVICE NAME 

VOLUME NAME 

20 ENTRIES IN 

VOLUME DIRECTORY 

BAD TRACK LIST LUNO 

(See Volume III) 

FLAGS (BYTE 22 CONTAINS 

TRACK 1 LUNO) 

DEFAULT PHYSICAL 

RECORD SIZE (768 is implied) 

HARDWARE INTERLEAVING 

(1 is implied) 

LUNO FOR TRACK 1 

LOADER (See Volume III) 

RESERVED (must be 0) 



7.17 INSTALL DISK VOLUME (CODE > 20) 

The Install Volume SVC must be used in order to make a disk volume available for file storage. The 
Install Volume SVC performs the following functions: 

Verifies that the given volume name matches the disk drive specified 

Verifies that the specified drive is available 

Builds the file control block for the volume directory 

Initializes memory to be used by the disk manager 

Deletes any temporary files on the disk 
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The call block is the same as the first 14 bytes of the Initialize Volume SVC, and has the following 
format: 



BYTE 

o 



1 2 



SVC CODE 


ERROR CODE 


DISK ID C4 ASCII CHARACTERS) 


VOLUME NAME 
(8 ASCII characters; 



2283091 



Byte 



1 
2-5 
6-13 



Description 

SVC code (> 20). 

Returned error code. 

Disk device name (for example, DS01 , DS03). 

Name of volume to be installed. If another volume is installed on the 
disk drive, the installed volume name is returned in this field, and byte 1 
will contain an error code. 



The following code is an example of an Install Volume SVC: 

EVEN 

INSVOL BYTE >20 SVC CODE 

BYTE RETURNED ERROR CODE 

TEXT 'DS02' DISK UNIT 02 

TEXT 'NEWVOL ' VOLUME TO BE INSTALLED 



SVC ©INSVOL INSTALL THE VOLUME 



7-28 



946250-9705 



Privileged Supervisor Calls 



7.18 UNLOAD DISK VOLUME (CODE > 34) 

This SVC unloads a volume that is no longer being used, usually with the intent of installing a new 
volume on the disk drive. The Unload Volume SVC performs the following functions: 

• Determines the device on which the specified volume is installed 

• Verifies that no LUNOs are assigned to files in this volume 

• Releases all memory allocated to support this volume 

• Updates the disk PDT to show that the volume is unloaded 

• Returns the physical device name 

The 14-byte call block has the same format as the Install Volume SVC, except that the disk ID in 
bytes 2 through 5 is returned by the system. The following is an example of an Unload Volume 
SVC: 





EVEN 






UNLVOL 


BYTE 


>34 


SVC CODE 




BYTE 





RETURNED ERROR CODE 


DISKID 


BSS 


4 


RETURNED DISK ID 




TEXT 


'OLDVOL ' 


VOLUME TO BE UNLOADED 



7.19 DIRECT DISK I/O 

In order to maintain disk file integrity and security, and to control disk allocation, direct disk (or 
diskette) I/O is reserved for use by privileged or system tasks, which have direct and global access 
to disk units. 

I/O to disk or diskette is controlled by an extended call block as described in paragraph 7.19.1. As 
with any other device, access is through a LUNO assigned to the disk. DX10 has a reserved system 
(nonreleasable) LUNO for each disk unit configured in the system. Action taken on the standard 
I/O opcodes for disk is described in paragraph 7.19.2, while diskette is described in paragraph 
7.19.3. Disks and diskettes are classified as record-oriented devices by DX10 and need not be 
opened before I/O operations or closed afterward. 
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Before tracks on a disk cartridge or a diskette can be used for data storage, they must be for- 
matted. That is, the physical record length of the records on a track must be defined on the disk 
pack. This is done when a system disk is built or when a secondary disk is initialized (see Section 
2). The actual physical organization of a disk pack is by heads (recording surfaces), cylinders 
(recording bands on all surfaces), and sectors (timing marks dividing each cylinder). A track is one 
surface of a cylinder and is the smallest unit which can be independently formatted. Tracks are 
addressed by the expression: c * H + h = T. 

T is the addressed track number 
H is the number of heads for the disk unit 
c is the addressed cylinder number 
h is the addressed head 

Figure 7-1 shows the manner by which tracks are addressed. 



CYLINDERS 




TRACK X ADDRESS - CYLINDER * TOTAL HEADS + ADDRESSED HEAD 
-2*8+5 
3 21 



2279565 



Figure 7-1. Addressing a Track 
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Track addressing runs sequentially from zero to the maximum track address. Each track is for- 
matted for a given physical record length (a physical record is the smallest unit of data transfer 
from the disk) with resulting records per track and sectors per record. Physical records must start 
at sector boundaries but need not fill entire sectors and may cross sector (but not track) bound- 
aries. Each record defined on a track requires a fixed amount of overhead, thus the larger the 
records, the fewer records per track, the less overhead required, resulting in more usable bytes per 
formatted track. Note that all disks initialized under DX10, Release 3.2 or later, (using the Initialize 
Volume command or SVC) are formatted one sector per physical record and that the FD800 
diskette supported by DX10 is also formatted one sector per record. 

CAUTION 

Reformatting a track after the disk has been initialized for DX10 use 
will destroy any data that is on the specified track. Also, if the for- 
mat is not one SECTOR/RECORD, DX10 will not be able to access 
that track except through user direct disk I/O. 

7.1 9.1 Direct Disk I/O Call Block 

The SVC block used for the Direct Disk I/O SVC is the same as a normal I/O call block, with a two- 
word extension used to contain a disk address. The call block has the following format: 



BYTE 






ERROR CODE 






2 


DISK I/O OPCODE 


I- UNO 




4 


SYSTEM FLAGS 


USER FLAGS 


> STANDARD 


6 


BUFFER ADDRESS 


CALL 
BLOCK 


8 


RECORD LENGTH 




10 


CHARACTER COUNT 




12 


TRACK ADDRESS 




14 


SECTORS/RECORD 


SECTOR NUMBER 






OR 




UNIQUE TO 
> DIRECT 
DISK I/O 


12 


ADU NUMBER 






14 


SECTOR OFFSET IN ADU 




2283105 
946250-9705 
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NOTE 

DX10 supports addressing by ADU/Sector offset or Track/Sector 
offset on Release 3 or later disk units. Direct disk I/O to CRU disk- 
ette must use the track/sector method of addressing. 



Byte Description 

SVC code (0). 

1 Error code returned by DX10. 

2 I/O opcode (see paragraphs 7.19.2 and 7.19.3). 

3 LUNO assigned to disk. 

4 Flags set by the system — when set high the following conditions are 
indicated: 

Bit — LUNO is busy. 

Bit 1 — Error. 

Bit 2 — End-of-file condition (not applicable). 

Bits 3 - 7 — Reserved. 

5 Flags set by user — when set high the following conditions are indi- 
cated: 

BitO — Initiate I/O. 

Bit 1 —User supplied format information pointed to by TRBDEJA. 

Bit 2 — Reserved (set to 0). 

Bit 3— Offset enable. 

Bit 4— Off set forward. 

Bit 5 —Transfer inhibit. 

Bit 6 — Reserved (set to 0). 

Bit 7 — Retry flag; 1 = no retries are to be done by the disk DSR. 
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Byte Description 

6-7 The address of the buffer to which data is to be read or from which data 

is to be written. Must begin on a word boundary. 

8-9 The length in bytes of a physical record. This number determines the 

maximum number of bytes transferred during a read. Must be an even 
count. 

10-11 The number of characters to be written. Must be an even count. DX10 

returns the number of characters read by a read operation in these 
bytes. 

The last two words of the call block vary according to the addressing mode of the I/O operation. If 
the address of the logical record is given as track and sector, then: 

Byte Description 

12-13 The track number in which the record is located (see Figure 7-1 for track 

addressing). 

14 The number of sectors per physical record. 

15 The starting sector number of the record. 
If the address is given as ADU/sector offset, then: 

Byte Description 

12-13 The ADU number in which the physical record starts. 

14-15 The starting sector number of the physical record within the ADU. This 

must be specified because ADUs may span physical records (that is, a 
record may start in the middle of an ADU). 
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7.19.2 Direct Disk I/O Opcodes 

I/O opcodes for direct I/O to disks do not have the same meanings as for other device I/O. (Diskette 
opcodes are described in paragraph 7.19.3.) Those I/O opcodes that are defined for the disk are 
defined as shown in Table 7-2 (all other opcodes are ignored by the disk). 



Table 7-2. Direct Disk I/O Opcodes 



imalOpci 


Dde I/O Function 


5,F 


Read Format 


8 


Write Format 


9 


Read by ADU 


A 


Read by Track 


B 


Write by ADU 


C 


Write by Track 


E 


Store Registers 



I/O Action 



12 



Returns disk and track format. 

Formats a track. 

Inputs data starting in the specified ADU 
and sector. 

Inputs data starting in the specified track 
and sector. 

Outputs data starting in the specified ADU 
and sector. 

Outputs data starting in the specified track 
and sector. 

Returns the disk parameter registers, which 
are the same as the first three words of the 
read format data. 



Write Interleaved Factor Writes format for interleaving to a double- 
sided, double-density (DSDD) track. 



7.19.2.1 Read Format (Opcodes >5 and >F). The Read Format command requires specifica- 
tion of a buffer address in bytes 6 and 7 of the call block and a track address in bytes 12 and 13. 
The specified buffer must begin on a word boundary. The record length specifies the number of 
bytes to be returned (must be even) up to 12 bytes. The character count, sectors per record, and 
sector number fields of the call block are ignored. Twelve bytes of disk and track data are returned 
in the user buffer as shown in Figure 7-2. 
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USER 
BUFFER 



WORDS/TRACK 



SECTORS/TRACK 



NO. HEADS (BITS 0-4) 



OVERHEAD/RECORD 



NO. CYCLINDERS (BITS S~ t 5) 



SECTORS/RECORD 



RECORDS TRACK 



WORDS/RECORD 



INTERLEAVING FACTOR 



2277819 



Figure 7-2. Store Registers and Read Format Data 



7.19.2.2 Write Format (Opcode >8). The Write Format command requires specification of a 
physical record length in bytes 8 and 9 of the call block, and a track address in bytes 12 and 13. 
The SCB buffer address, character count, and sector number fields are ignored. The addressed 
track is formatted to the given record length and the resulting number of sectors per record is 
returned in byte 14 of the call block. 

7.19.2.3 Store Registers (Opcode > E). The Store Registers command transfers the disk para- 
meters registers into the specified user buffer. The buffer address is specified in bytes 6 and 7 of 
the call block and must begin on a word boundary. The record length specifies the number of 
bytes to be returned (must begin on even boundary) up to 6 bytes. Bytes 10 through 15 of the SCB 
are ignored. Six bytes of disk format data are returned in the buffer as shown in Figure 7-2. 

Bytes through 11 are returned for read format opcodes (>5 and > F), and bytes through 5 are 
returned for store register opcode (> E). 

7.19.2.4 Read by ADU (Opcode > 9). The Read by ADU command transfers data from the disk to 
the specified buffer. The data buffer address is specified in bytes 6 and 7 of the SVC call block and 
must begin on a word boundary. The length of the physical record to be read is specified in bytes 8 
and 9 and must be an even number. The ADU number and sector offset from which to read the 
record are specified in bytes 12 through 15. The number of characters actually read is placed in 
bytes 10 and 1 1 by the system. 
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7.19.2.5 Read by Track (Opcode > A). The Read by Track command transfers data from the disk 
to the specified buffer. The buffer address is specified in bytes 6 and 7 of the call block and must 
begin on a word boundary. The record length is specified in bytes 8 and 9, and must be an even 
number. The track address is specified in bytes 12 and 13 and the sectors per record and starting 
sector number are specified in bytes 14 and 15. The number of characters read is returned in bytes 
10and11. 

Bits 3, 4, 5, and 7 of byte 5 control alternative disk operations. When set: bit 3 enables head offset; 
bit 4 enables head offset forward; bit 5 enables transfer inhibit; and bit 7 disables retries. 

7.19.2.6 Write by ADU (Opcode > B). The Write by ADU command transfers data from a speci- 
fied buffer to a specified address on disk. The buffer address is specified in bytes 6 and 7 of the 
call block and must begin on a word boundary. The number of characters to write is specified in 
bytes 10 and 1 1 and must be an even number. The disk address to which the data is to be written is 
specified by the ADU number and sector offset in bytes 12 through 15 of the call block. If the char- 
acter count is not an integral number of sectors, the remainder of that sector will be zeroed out. 

7.19.2.7 Write by Track (Opcode > C). The Write by Track command transfers data from a speci- 
fied buffer to a specified address on disk. The buffer address is specified in bytes 6 and 7 of the 
call block and must begin on a word boundary. The number of characters to write is specified in 
bytes 10 and 1 1 and must be an even number. The disk address to which the data is to be written is 
specified by the track address in bytes 12 and 13 and the sectors per record and starting sector 
number in bytes 14 and 15. 

7.19.2.8 Write interleaved Factor (Opcode >12). The Write Interleaved Factor command speci- 
fies an interleaving factor for a disk or DSDD diskette track. The operation can specify the data pat- 
tern used in formatting the disk or diskette. The operation is otherwise identical to the Write 
Format operation, opcode >08. Flags in the user flag field apply as follows: 

Byte Description 

5 Flags: 

Bit — Initiate flag. If 1 , the system initiates the operation 
and returns control to the calling task. If 0, the system sus- 
pends the calling task until the operation has completed. 

Bit 1 — Format data location flag. If 1 , data is in the buffer 
block. If 0, data is in the call block. 

The input character count field must be specified as the number of bytes per record. 



7-36 Change 1 946250-9705 



Privileged Supervisor Calls 



When the format data location flag is set to 1, a two-word buffer with the following contents is 
required: 



INITIALIZATION PATTERN 



INTERLEAVING FACTOR 



BYTE 
6 

8 
2285638 

When the format data location flag is set to zero, the write character count field (bytes 1 and 1 1 ) of 
the supervisor call block contains the interleaving factor. 

The following is an example of the source code for a supervisor call block to format track 40 on a 
diskette with an interleaving factor: 



FMTI 



DATA 





BYTE 


>12,>D4 


DATA 





DATA 





DATA 


256 


DATA 


3 


DATA 


40 


DATA 






FORMAT TRACK 40 ON DISKETTE 
ASSIGN ED TO LUNO >D4WITH 
INTERLEAVING FACTOR OF 3 



SVC 



@FMTI 



The buffer address is specified in bytes 6 and 7 of the call block and must begin on a word bound- 
ary. The interleaving factor is specified in bytes 10 and 11. The track address is specified in bytes 
12 and 13. 

7.19.3 Direct Diskette I/O 

Some of the I/O opcodes for diskette operations, shown in Table 7-3, are the same as for disk, 
although DX10 does not support diskette addressing by ADU/sector offset. In addition, diskette 
I/O allows some special functions, such as specifying logical track numbers and sector sizes. The 
following paragraphs describe the I/O operations for diskette which are supported by DX10. 

7.19.3.1 Read Format (Opcodes >5 and > F). This command is exactly the same as for disk, 
except that a track address is required in bytes 12 and 13 of the I/O call block. Bytes 6 and 7 must 
contain the address of a 5-word buffer, which must begin on a word boundary, in which the system 
returns the same information as returned for disk (shown in Figure 7-2). All other fields in the call 
block are ignored. 



946250-9705 



Change 1 



7-36A/7-36B 



Privileged Supervisor Calls 



Table 7-3. Diskette Direct Disk I/O Opcodes 



Hexadecimal Opcode 


I/O Function 


I/O Action 





Open 


Ignored (device type returned) 


1 


Close 


Ignored 


2 


Close EOF 


Ignored 


3 


Open Rewind 


Ignored (device type returned) 


4 


Close Unload 


Ignored 


5 


Read Format 


Return disk/track format 


6 


Forward Space 


Ignored 


7 


Back Space 


Ignored Formats Track 


8 


Write Format 


Formats Track 


9 


Read ASCII 


Read data 


A 


Read Direct 


Read data 


B 


Write ASCII 


Write data 


C 


Write Direct 


Write data 


D 


Write EOF 


Ignored 


E 


Rewind 


Ignored 


F 


Read Format 


Return disk/track format 


10 


Write Deleted Sector 


Writes delete code on sector 


11 


Read Deleted Sector 


Reads delete code on sector 



7.19.3.2 Write Format (Opcode > 8). This command requires a track address in bytes 12 and 13 
of the call block, and a record length, given in bytes, in bytes 8 and 9. All other fields in the call 
block are ignored. DX10 formats the specified track, and returns the number of sectors per record 
in byte 14. 

7.19.3.3 Read ASCII (Opcode >9), Read Direct (Opcode >A). These two commands transfer 
data from the diskette to the user buffer whose address is specified in bytes 6 and 7 of the I/O call 
block. The length of the buffer is given in bytes 10 and 11, and must be an even number. Bytes 12 
and 13 specify the track from which the data is to be read, byte 14 is the number of sectors per 
record on that track (should be 1), and byte 15 is the sector number on the track at which the read 
operation should begin. Under DX10, there is no difference between the Read ASCII and Read 
Direct commands. The system returns the actual number of characters read in bytes 10 and 1 1 . 

7.19.3.4 Write ASCII (Opcode > B), Write Direct (Opcode > C). These commands transfer data 
from the user buffer, pointed to by bytes 6 and 7 of the call block, to the diskette. Bytes 12 through 
15 contain the track/sector address, as described in paragraph 7.19.3.3. Bytes 10 and 11 specify 
the number of characters to be written (must be an even number). DX10 makes no distinction 
between the Write ASCII and Write Direct commands. 

7.19.3.5 Write Deleted Sector (Opcode >10). The diskette controller can delete a sector by 
writing a special data pattern on it. This operation can be performed by specifying a >10 opcode 
(byte 2) and a track/sector address (bytes 12 through 15) in a normal I/O call block. 
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7.19.3.6 Read Deleted Sector (Opcode >11). This operation is used to read the special data 
pattern written on a sector by the Write Deleted Sector operation. The Read Deleted Sector opera- 
tion may be performed by specifying >11 opcode (byte 2) and a track/sector address (bytes 12 
through 15) in a normal I/O call block. 

7.19.3.7 Special Diskette Options. In addition to the operations described above, the diskette 
controller allows two options, variable sector lengths and logical track numbering. 

For any Read or Write operation, the user can specify the size of a sector, in the range of 2 to 128 
bytes. The sector length must be even, and is assumed to be 128 bytes unless otherwise specified. 
A smaller sector size for an I/O operation results in unused disk space (the difference between 128 
and the specified sector size). To specify the sector length, bit 6 of the user flags (byte 5 of the call 
olock) must be set to one and the desired sector size placed in byte 14 (normally used for sectors/ 
record). 

Logical track numbering allows the user to assign an address to a track different from the physi- 
cal address of that track. This option enables the user to skip bad tracks in the track numbering. 
Logical numbers should still increase from zero as the head travels inward on the diskette, as do 
the normal addresses. Figure 7-3 shows a logically numbered disk. 



PHYSICAL ADDRESS 



LOGICAL ADDRESS 




BAD TRACK 



228 3092 



Figure 7-3. Logical Track Addressing 



To assign a logical address to a track, a write format operation must be performed. Bit 6 of 
the user flags (byte 5) must be set to one, and the address to be assigned to the track must be in 
byte 14. 
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8.1 INTRODUCTION 

New releases of DX10 incorporate improved methods of operation. These improvements include 
changes to techniques of formatting and accessing mass storage devices. Data files stored by 
systems running under releases of DX10 prior to Release 3.0 are not compatible with later 
releases of DX10. If you possess any such files, you must convert them to the current format. This 
section discusses the methods to perform this conversion. 

8.2 DX10 2.X DISK CONVERSION 

The procedure for transferring data files from a DX10 2.X disk to a Release 3 or later version disk 
varies depending on the hardware configuration of the system. The following paragraphs describe 
such procedures for the two types of systems: single disk with magnetic tape, and multiple disk 
systems. 

8.2.1 Disk/Magnetic Tape Configuration 

Transferral of sequential files and sequential library members from a 2.X disk to a Release 3 or 
later version disk involves no more than copying the 2.X files to an unformatted magnetic tape 
(operating under the 2.X system), installing the new version disk and loading the new system, and 
then copying the magnetic tape to a new directory, using the Copy/Concatenate (CC) command. 
The following is a step-by-step procedure for converting 2.0 sequential files and library members: 

1. Copy all 2.0 sequential files and sequential library members to an unformatted tape (or 
tapes) using the CC command. Write down each file name as it is copied, maintaining a 
list of the files. 

2. Install a Release 3 or later version system disk, perform an initial program load (IPL), and 
bid SCI. 

3. Rewind the starting tape. 

4. Create a directory under which the 2.X files are to be cataloged, using the Create Direc- 
tory File (CFDIR) command (this step is optional). 

5. Copy the files from tape to disk using the CC command. Use the written list in order to 
get the files from the tape in the correct order. 
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8.2.2 Multiple Disk Configuration 

For systems with more than one disk drive, 2.X file conversion is much simpler. Once a Release 3 
or later version system is running, you can convert the 2.0 files by executing the disk conversion 
utility. The utility runs under the DX10 Release 3 or later version operating system and requires at 
least two disk drives, one for the 2.X disk and one for a new version disk. The 2.X disk may remain 
write protected since the conversion utility only reads it. The new version disk must be initialized 
and installed, though not necessarily empty. The utility converts any or all of the 2.X files (except 
system files and indexed files) and writes them on the new version disk. Sequential and relative 
record files (both contiguous and noncontiguous) on the 2.X disk are converted to unbounded 
sequential and relative record files (respectively) on the Release 3 or later version disk. User file 
directories and libraries on the 2.X disk are converted into the new version directory files. If a 2.X 
file has the same pathname as a Release 3 or later version file, it is not converted, in order to avoid 
pathname conflicts. 

8.2.2.1 Operating Procedure. When converting 2.X files, you have the option of placing the 2.X 
files under a Release 3 or later version directory or simply under the volume catalog of the disk 
receiving the files. By being cataloged under the volume catalog, the 2.X files retain the same 
pathnames as on the 2.X disk, a valuable characteristic when using programs developed under 
DX10 2.X. However, placing the 2.X files under a newly created Release 3 or later version directory 
avoids the possibility of pathname conflicts. 

If the 2.X files are to be cataloged under a new version directory, the directory must exist before 
executing the conversion utility. In addition, the pathname of the directory may not exceed 27 
characters in length (including periods). 

To activate the conversion utility, issue the Execute 2.2 to 3.0 Disk Conversion (XCU) command. 
The following prompts appear: 

[ ]XCU 

EXECUTE 2.2 TO 3.0 DISK CONVERSION 

DISK TO BE CONVERTED: < acnm> 
LISTING DEVICE: < acnm> 

You must specify the disk drive that contains the 2.X disk to be converted and a listing device to 
which the utility should send any error messages and the log of converted files (see paragraph 
8.2.2.2). 

After you answer these prompts, the conversion utility prompts for the access name of a disk or a 
directory (if desired) under which the 2.X files are to be cataloged, as follows: 

OUTPUT DISK NAME?: < acnm> 

The default value for < acnm> is the system disk, with ail 2.X files and libraries cataloged under 
the volume catalog (VCATALOG) with their 2.X pathnames. You can specify any disk in the sys- 
tem. You can specify any existing Release 3 or later version directory hierarchy under which the 
2.X files should be cataloged, provided that the directory hierarchy has already been defined (as 
explained previously). 
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After you specify the output disk name, the conversion utility begins converting files. At this point, 
you have the option of converting all 2.X files or only specific files. The following prompt appears: 

CONVERT FILE <pathname> (Y/N/A/S)? 

You should respond with one of the following: 

Response Action 

Y(yes) Converts this file (< pathname>). The file 

is converted (if possible), and the utility 
prompts for the next file. 

N (no) Does not convert this file. The utility 

prompts for the next file. 

A (all) Converts all files on the directory 

specified by <pathname>. The utility ter- 
minates. 

S (stop) Terminates the conversion utility. 

Whenever the conversion utility converts a 2.X file, the pathname of the Release 3 or later version 
file is the old 2.X pathname appended to whatever you responded to the OUTPUT DISK NAME? 
prompt. The following table shows how the conversion utility names converted files: 

User Response to New Pathname of 2.X 

OUTPUT DISK NAME? File UFD1.LIB1 (MEM1) 

<default> .UFD1.LIB1.MEM1 

.MYCAT .MYCAT.UFD1.LIB1,MEM1 

DS03.MYCAT.DX2XFILE DS03.MYCAT.DX2XFILE.UFD1.LIB1.MEM1 
DS02 DS02.UFD1.LIB1.MEM1 



NOTE 

For compatibility purposes, DX10 Release 3 or later versions sup- 
ports the 2.X convention of enclosing a library member name in 
parentheses, rather than delimiting it with a period. For example, 
the file in Example 2 can be referred to as the following: 

.MYCAT.UFDI.LIB(FILEA) 

8.2.2.2 Converted File Log. In addition to writing the converted 2.X files to the new version disk, 
the conversion utility writes a log of the files converted to the listing device. Figure 8-1 shows a 
sample log. 
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DX10 R2.2 DISK CONVERSION 
R2.2 DISK: TPLHOSE 

PATHNAME 

.JON.TPL 
.JON.TPL.SRC 
.JON.TPL, SRC. IOF 
.JON.TPL. SRC. LNK 
.JON.TPL.SRC. DRV 
.JON.TPL. SRC. STK 
.JON.TPL. SRC. DSP 
.JON.TPL. SRC. LGC 
.JON.TPL. SRC. MAN 
.JON.TPL. SRC. NTR 
.JON.TPL.SRC. CHR 
.JON.TPL. OB J 
.JON.TPL. OBJ. IDS 
.JON.TPL. OB J. IOF 

END R2.2 DISK CONVERSION 



OT 



NT 



u 


D 


L 


D 


BM 


NS 


BM 


NS 


BM 


NS 


BM 


NS 


3M 


NS 


BM 


NS 


BM 


NS 


BM 


NS 


BM 


NS 


L 


D 


NM 


NS 


NM 


NS 



CC 



Figure 8*1. Sample Log of Converted Files 



The PATHNAME log entry is the new Release 3 or later version pathname of the file, with the old 
2.X pathname appended to the new pathname specified in response to the OUTPUT DISK NAME?: 
prompt. 

The OT entry is the old 2.X file type. NT is the new version file type. The file types are: 



U 

L 

D 

BM 

NM 

CR 

NR 

CS 

NS 

CI 

Nl 

A 



User file directory (old type only) 

Library (old type only) 

Directory (new type only) 

Blank suppressed library member (old type only) 

Nonblank suppressed library member (old type only) 

Contiguous relative record file (old type only) 

Noncontiguous relative record file 

Contiguous sequential file (old type only) 

Noncontiguous sequential file 

Contiguous indexed file (old type only) 

Noncontiguous indexed file (old type only) 

Alias 



The CC log entry is a completion code. A blank CC field indicates no error. An S means that the 2.X 
file was a system file and was not converted. If an alias was successfully converted, this field con- 
tains the name of the file to which the alias is assigned. Other codes indicate that a file conver- 
sion was aborted. They are preceded by an asterisk (*) and have three fields. 
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Field 1 specifies what was aborted and may be one of the following: 

Value Meaning 

X The whole 2.X disk was aborted. 

C The whole catalog 

U Everything under a 2.X user file directory 

L The whole library 

M A library member 

F A file 

A An alias 

Field 2 specifies the source of the error: 

Value Meaning 

D Error detected at the DX10 Release 3 or later version disk 

2 Error detected at the 2.X disk 

Error detected by the conversion utility 

Field 3 specifies what error was detected. If the error was detected by the utility (for example, 
Field 2 was 0), it may be one of the following: 

Value Meaning 

01 Physical record size of the 2.X file is too large for the utility 
buffers (greater than 1000 bytes). 

02 Blank suppressed logical record size is too large for the utility 
buffers (greater than 200 bytes). 

03 Sequential file EOF block error. 

If the error was detected at either disk, Field C is the error code returned by an I/O SVC processor. 
Volume VI documents these error codes. 

8.3 DX10 2.X SVC COMPATIBILITY 

In addition to the SVCs described in Section 7 and in Volume III, DX10 Release 3.0 supports some 
SVCs strictly for the purpose of compatibility with programs developed under a 2.X system. Other 
SVCs are no longer supported. The following paragraphs describe SVC differences between DX10 
2.X and Release 3 or later versions. 
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DX10 2.X Compatibility 



8.3.1 SVCs Not Supported 

The following 2.X SVCs are not supported by DX10 Release 3 or later versions: 

Abort I/O (by PRB — code > 1 E) 

Set Condition Bit (code > 19) 

Get Character (code > 8) 

Conditional Get Character (code > 18) used with VDT character mode 

913 VDT Utility (code >1 A) 

The three SVCs used to support the 913 VDT in character mode have been replaced by an exten- 
sion to the I/O supervisor call block, as explained in Volume III. 

8.3.2 SVCs Supported Only for Compatibility 

The following SVCs are supported by DX10 Release 3 or later versions only to be compatible with 
2.X programs: 

• FUR Utility Call (code > 15) 

• Librarian I/O Opcodes (SVC code > 00, opcodes > 80 through > 8F) 

• End of Program (code > 1 6) 

• Bid Task (code > 5) 

The call blocks are the same in DX10 Release 3 or later versions as in 2.X. Support for these SVCs 
will be discontinued in a future release. 

8.3.3 SVCs Still Used But Different 

Some SVCs under DX10 Release 3 or later versions have the same form (call block, opcode) as in 
2.X but are implemented differently and have new uses: 

• Get Memory (code > 12) — A Get Memory SVC in Release 3 or later versions automati- 
cally causes the task to be rolled out and therefore may not be used by memory-resident 
tasks or tasks with system common mapped in. 

• Bid Task (code > 5) and Scheduled Bid Task (code > 1 F) — These two SVCs may only bid 
nonreplicatable tasks installed on the system program file. 

• Activate Time Delayed Task (code > E) and Activate Suspended Task (code > 7) — The 
specified task ID must be the run-time ID (not the installed ID). 

• Load Overlay (code > 14) — The LUNO specified should be assigned to a program file, 
and overlay numbers must be in the range from through 255. 
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Appendix A 
Keycap Cross-Reference 



Generic keycap names that apply to all terminals are used for keys on keyboards throughout this 
manual. This appendix contains specific keyboard information to help you identify individual keys 
on any supported terminal. For instance, every terminal has an Attention key, but not all Attention 
keys look alike or have the same position on the keyboard. You can use the terminal information in 
this appendix to find the Attention key on any terminal. 

The terminals supported are the 931 VDT, 911 VDT, 915 VDT, 940 EVT, the Business System 
terminal, and hard-copy terminals (including teleprinter devices). The 820 KSR has been used as a 
typical hard-copy terminal. The 915 VDT keyboard information is the same as that for the 911 VDT 
except where noted in the tables. 

Appendix A contains three tables and keyboard drawings of the supported terminals. 

Table A-1 lists the generic keycap names alphabetically and provides illustrations of the 
corresponding keycaps on each of the currently supported keyboards. When you need to press 
two keys to obtain a function, both keys are shown in the table. For example, on the 940 EVT the 
Attention key function is activated by pressing and holding down the Shift key while pressing the 
key labeled PREV FORM NEXT. Table A-1 shows the generic keycap name as Attention, and a 
corresponding illustration shows a key labeled SHIFT above a key named PREV FORM NEXT. 

Function keys, such as F1, F2, and so on, are considered to be already generic and do not need 
further definition. However, a function key becomes generic when it does not appear on a certain 
keyboard but has an alternate key sequence. For that reason, the function keys are included in the 
table. 

Multiple key sequences and simultaneous keystrokes can also be described in generic keycap 
names that are applicable to all terminals. For example, you use a multiple key sequence and 
simultaneous keystrokes with the log-on function. You log on by pressing the Attention key, then 
holding down the Shift key while you press the exclamation (!) key. The same information in a table 
appears as Attentionl(Shift)!. 

Table A-2 shows some frequently used multiple key sequences. 

Table A-3 lists the generic names for 91 1 keycap designations used in previous manuals. You can 
use this table to translate existing documentation into generic keycap documentation. 

Figures A-1 through A-5 show diagrams of the 911 VDT, 915 VDT, 940 EVT, 931 VDT, and Business 
System terminal, respectively. Figure A-6 shows a diagram of the 820 KSR. 
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Table A-1 . Generic Keycap Names 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



Alternate 
Mode 



ALT 



r-^ 


ALT I 


/**** 



Attention 2 





** Iliil^v 




n«™a 




)£^ZM 



S 



Back Tab 




SHIFT O 





S::: 












is-5§ 



Command 2 







F^r^TI 



X 



Control 



CH 



^ 7 


CTRL § 


r"' ^ 



^ * 



l^¥^i 




fc^Twffll 



Delete 
Character 











DEL 
CHAR 











is—** 



DEL 
CHAR 



^ * 



l^~"^i 



Enter 




l^T*« 



Y 



Erase Field 



ERASE 
FIELD 



|£ 



r 






• 

ERASE 
FIELD 


c 





m 


m 




1 


1 

> 












> — i* 

i 




, i , 







Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 

! On a 915 VDT the Command Key has the label F9and the Attention Key has the label F10. 
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Keycap Cross-Reference 



Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



Erase input 



Exit 



Forward Tab 



F1 



F2 



F3 



F4 



Notes: 



911 
VDT 



ERA3€ 
(NPUT 



17=1 



ESC 






TAB 
SKIP 



fiakMiilliiiKliliil 



940 
EVT 



F2 



lUwMiiiiiiiid 



5 


~7 






FS: 


■J 



F«t 












931 
VDT 



r 






ERASE 
INPUT 


c 





shiftO 



ESC 



TAB 



FF=1 



Ft 



F2 



Business 
System 
Terminal 





■ 




F3 






if^^^^^^^ii 



'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 
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820 1 
KSR 



N 



ESC 




s 






B 






kz 



S 
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Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



F5 



F6 



F7 



F8 



F9 



F10 



911 
VDT 



*$■ j 



m 



1 



940 
EVT 



4m 




m 









m 






u= 



931 
VDT 



Pv=il 



k<r-H 



F6 



FF 



Q 



Ft 



v FtO „ : 



Business 
System 
Terminal 





H 





■ 




H 



820' 
KSR 




E 



V M 



F , ; 





L— * 




W 




a 



Z 
/ — Si 



Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPO Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 

2284734 (4/1 4) 



A-4 



946250-9705 



Keycap Cross-Reference 



Table A-1 . Generic Keycap Names (Continued) 



Generic Name 



F11 



F12 



911 
VDT 



B 



6a 



14. 



940 
EVT 








931 
VDT 



_ F1* : 
KS 



Business 
System 
Terminal 








820' 
KSR 



l: 



F13 



b—j 




shift O 




A 



Kg 




FT 



r^^^^^ 




F14 








SHtFT-O 






& 







H 




? 9 





l^= 



Home 





Initialize Input 




[£S 




Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPO Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 
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Keycap Cross-Reference 



Table A-1. Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 1 
KSR 



Insert 
Character 



INS K 



m 




== 1 

INS: ! 

CHARs 



Next 
Character 



Next Field 



mmlim 






GHAB I 




shift ■<> 




FELO 




Next Line 





l£ 





"Ji 



LINE 
FEED 



Previous 
Character 



immSb 





fZ 



CHAR 



Previous Field 





FIELD 








FIELD 





Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 
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Keycap Cross-Reference 



Table A-1. Generic Keycap Names (Continued) 



Generic Name 



911 
VDT 



940 
EVT 



931 
VDT 



Business 
System 
Terminal 



820 ' 
KSR 



Previous Line 



a 





m 



Print 



Repeat 



Return 



Shift 



Skip 



PRINT 




PRINT 






See 
Note 3 



See ' 
Note 3 



See 
Note 3 








TAB 
SKIP 



i 




Y in J 



L£ 






Uppercase 
Lock 




B 



CAPS 
LOCK 



^ ^ 






Notes: 

'The 820 KSR terminal has been used as a typical hard-copy terminal with the TPD Device Service 
Routine (DSR). Keys on other TPD devices may be missing or have different functions. 

The keyboard is typamatic. and no repeat key is needed. 
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Keycap Cross-Reference 



Table A-2. Frequently Used Key Sequences 



Function Key Sequence 



Log-on Attention/(Shift)! 

Hard-break Attention/(Control)x 

Hold Attention 

Resume Any key 



Table A-3. 911 Keycap Name Equivalents 



911 Phrase Generic Name 



Blank gray Initialize Input 

Blank orange Attention 

Down arrow Next Line 

Escape Exit 

Left arrow Previous Character 

Right arrow Next Character 

Up arrow Previous Line 
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Keycap Cross-Reference 



o 
u 

< 
h 
10 



z 
o 

p ^ 

oifl < 
z> 

Dili 



og OS Frrtfr 
t- - 

OS OS 

t- o 



os o; 



o* Os 



T 



pS33 



£ 



ij ' ■ '*3f f 



fig 



>• -* i; 



IS 
m ■■■*■■ 



b. 






3 




O 




>» 




(0 




_l 




T3 




L_ 




(0 




o 




.a 




>» 




a> 




* 




T3 


>> 


i_ 


p 


(0 

■o 


z 


c 


u 


(0 

4-* 


<(/) 


(0 


b>- 


1- 


<1U 


Q 


O* 


> 




in 




^< 




CD 




c4 




< 




0> 




fc- 




3 




O) 
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m 






L^J 







ewwB 



2 

:i~"* 








s : ; 



2 



--0 



$; 



/ — ^ 



=31 



F^El 



(«=33 ^— ^ 








0BH 



H 



qsa 



Wl 



<o|SJ^§l 



:i6= 




!« 



OQ 



o 

>% 

CD 



CO 

o 

.a 

>i 
o 



CO 

■o 

c 

CO 

1- 

Q 

> 

CO 

01 



< 

3 
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mm 







Jk»; 




NtfMH^ 


Br 


B=Pi 


U"Ca- : 




jUkk 




o 

(0 
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re 

CO 
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Appendix B 
Syste m Task IDs 



Table B-1 provides a list of the system task IDs. 



Table B-1. System Task IDs 



Code 


Name 


Purpose 







RES00 


Reserved 




1 


SMMAP 


Display Memory Map 




2 


SCILMT 


SCI Foreground Limitation Task 




3 


MLP 


Modify LUNO Protect 




4 


SLMFOT 


Format System Log 




5 


TMSSBD 


Scheduled Bid Task 




6 


TXSF 


TX Set System File 




7 


DCOPY 


Disk to Disk Copy 




8 


CPYSEQ 


Copy Sequential Media 




9 


PF$LIN 


Install Task 




A 


TM$DGN 


Diagnostic Task 




B 


FUTIL 


File Utility Task 




C 


SD 


Disk Scan 




D 


OQSCOPY 


SCI Output Queuer 




E 


PATCHSYN 


Patch Synonym Generator 




F 


SSTM 


Show System Table Map 




10 


PFSLDE 


Delete Task 




11 


CVD 


Copy and Verify Disk 




12 


TRCTSK 


Reserved 




13 


PF$LMN 


Map Name to ID/ID to Name 




14 


SYSRST 


System Restart Task 




15 


SVCKIL 


Kill Task 




16 


INSTAL 


Install/Unload Disk Volume 




17 


SIS 


Show I/O Status 




18 


MADSAD 


Modify/Show Absolute Disk 




19 


IDT 


Initialize Date and Time 




A1 


CHKDSK 


Check Disk Structures 




1B 


RTSTSK 


Remote Terminal Subsystem Download Task 




1C 


MPISPI 


Map/Show Program Image 




1D 


STS 


Show Task Status 




1E 


SLCMDP 


Start Log Command Processor 




1F 


PF$LAS 


Assign Space on a Program File 




20 


SCI990 


System Command Interpreter 




21 


MRFSRF 


Modify/Show Relative to File 




22 


MAPDSC 


Map Disk 




23 


BRM 


SCI Background Resource Manager 




24 


QBID 


SCI Queue Bidder 




25 


OQ$MGR 


SCI Output Queuer 




26 


BD 


Backup Directory 
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Table B-1. System Task IDs (Continued) 



Code 



Name 



Purpose 



27 

28 

29 

2A 

2B 

2C 

2D 

2E 

2F 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

3A 

3B 

3C 

3D 

3E 

3F 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

4A 

4B 

4C 

4D 

4E 

4F 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 



RD 


Restore Directory 


CD 


Copy Directory 


DD 


Delete Directory 


SORTMG 


Sort/Merge 


LLR 


List Logical Record 


CKS 


Copy KIF to Sequential File 


DES 


DES (Sort/Merge) 


OCPRAL 


Release All LUNOs 


CONVRT 


Convert 2.2 Disk to 3.X Disk 


ISOLNK 


Install System Overlay 


MVI$ 


Modify Volume Information 


LD 


List Directory 


GEN990 


System Generation 


SSCCAF 


Copy/Concatenate and Append File 


AT 


Activate Suspended Task 


LSTSYN 


List Synonyms 


SVS 


Show Volume Status 


FILMAP 


Map Program File 


CPI 


Copy Program Image 


TXMD 


TX Map Disk 


TXFD 


TX Format Diskette 


TXCP 


TX Change Protection 


TXDX 


TX to DX Conversion 


DXTX 


DX to TX Conversion 


VC 


Verify Copy 


VB 


Verify Backup 


IBMUTL 


IBM Conversion Utility 


MKL 


Modify Key Indexed File Logging 


ERRADD 


Add Error Message 


ITGS 


Install Generated System 


MMPACK 


Memory Packing 


ERRSHW 


Show Error Message 


RES47 


Reserved 


CKSR 


Copy KIF to Sequential Randomly 


RES49 


Reserved 


GETLOG 


Determine Log File to Use 


KIFPRC 


Reserved 


INVOL 


Install New Volume 


RWCRU 


Read/Write From/To CRU Address 


LDC 


List Device Configuration 


MDS 


Modify Device Status 


MCCSCC 


Modify/Show Country Code 


TAMER 


Reserved 


SPL 


Print File from Task 


RCD 


Recover Disk 


DPLNKERR 




RES55 


Reserved 


IDS 


Initialize Disk Surface 


RES57 


Reserved 


RES58 


Reserved 


RES59 


Reserved 
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Table B-1. System Task IDs (Continued) 



Code 


Name 


Purpose 




5A 


CALANS 


Call Terminal/Answer Incoming Call 




5B 


DISC 


Disconnect Terminal 




5C 


MHPC 


Modify Hard-copy Terminal Port Characteristics 




5D 


LHPC 


List Hard-copy Terminal Port Characteristics 




5E 


SLA1 


System Log Analysis — Level 1 




5F 


SLA2 


System Log Analysis — Level 2 




60 


IPFTSK 


International Print File Task 




61 


RES61 


Reserved 




62 


CKR 


Copy KIF Randomly 




63 


EDITOR 


Text Editor 




6B 


ANALZ 


Analyze Crash Dump 




6C 


DEBUG 


DX10 Debugger 




7B 


IFSVC 


SVC Processor 




82 


MODSYN 


Modify Synonyms 




83 


TINFO 


Terminal Information 




84 


OUTQUE 


Print Output Queuer 




85 


MTMPMO 


MTE, MPE, MOE 




87 


CRV 


Check and Reset Volume 




A0 


SMS 


Show Memory Status 




A3 


QSCOMM 


DX10 HDLC Queue Server (> 4D SVC) 




A4 


PCDUMP 


PC counter 




A5 


RESA5 


Reserved 




A6 


RESA6 


Reserved 




DB 


DBM 


Data Base Manager 




EO-EF 




Reserved for User Tasks 




FO-FD 




Reserved for Communication Tasks 
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Appendix C 
System Overlay IDs 



Table C-1 provides a list of the system overlay ID numbers in the system overlay file. Table C-2 
provides a list of the system task and utility overlay ID numbers in the system program file. 



Table C-1. System Overlay Numbers (.S$0VLY A) 



Code 


Name 


Purpose 







TM$OVI 


TM$BID error recovery 




1 


OLN005 


KIF, splitaB-Tree 




2 


OLN006 


KIF, insert a record 




3 


OLN007 


KIF, rewrite a record 




4 


OLN00A 


KIF, open/close processor 




5 


OLN00B 


KIF, delete a record 




6 


OLN00C 


KIF, delete B-tree entry overlay 




7 


FMOV10 


File Management, rewrite, space 




8 


FMOV11 


File Management, write EOF, rewind, unlock 




9 


FMOV12 


File Management 




A 


FMOV13 


File Management, open extend 




B 


DMOVOD 


Disk Manager 




C 


DMOVOE 


Disk Manager 




D 


DMOVOF 


Disk Manager 




E 


DMOV14 


Disk Manager 




F 


TM$RWO 


Task Manager 




11 


PLGERR 


KIF, error recovery 




Table 


C-2. System Task and Utility Overlay Numbers (.S$PROGA) 




Code 


Name 


Purpose 







RESOO 


Reserved 




2 


PARSER 


System Command Interpreter PARSER 




3 


E$EDIT 


Text Editor Edit Mode 




4 


E$CMD$ 


Text Editor Command Mode 




5 


INFT 


System Generation 




6 


INTACT 


System Generation 




7 


BUILD 


System Generation 




1B 


IFROOT 


SCI SVC Processor Main Routine 




1C 


l$OSVC 


SCI SVC Processor SVC Section 




1D 


l$OUCB 


SCI SVC Processor UCB Section 




1E 


l$OERR 


SCI SVC Processor Errors 
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Table C-2. System Task and Utility Overlay Numbers (.S$PROGA) (Continued) 



Code 


Name 


Purpose 


21 


DERROR 


System Command Interpreter Errors 


22 


MODSYN 


SCI Modify Synonym 


23 


TINFO 


Terminal Information 


24 


OUTQUE 


CMD-990 Output Queuer 


25 


MTMPMO 


SCI Modify Task/Overlay/Procedure Entry 


26 


XSRTGEN 


Sort/Merge 


27 


XTRANSL 


Sort/Merge 


28 


XHEADER 


Sort/Merge 


29 


XRECORD 


Sort/Merge 


2A 


XFIELD 


Sort/Merge 


2B 


XSORT 


Sort/Merge 


2C 


XSRTINT 


Sort/Merge 


2D 


XSRT 


Sort/Merge 


2E 


XLASPAS 


Sort/Merge 


2F 


XRLMGR 


Sort/Merge 


30 


XMRGINT 


Sort/Merge 


31 


XMERGER 


Sort/Merge 


32 


l$OSVC 


SCI SVC Processor SVC Section 


32 


COBOLOV1 


COBOL (DX5 only) 


33 


l$OUCB1 


SCI SVC Processor UCB Section 


33 


COBOLOV2 


COBOL (DX5 only) 


34 


l$OERR2 


SCI SVC errors 


34 


COBOLOV3 


COBOL (DX5 only) 


40 


SMS 


SCI Show Memory Status 


41 


XKDATA 


SCI Procedure/Data Support 


5E 


SLA1 


System Log Analyzer 


5F 


SLA2 


Online Diagnostics 


60 


FUTOV0 


File Utility Overlay 


61 


FUTOV1 


File Utility Overlay 


62 


FUTOV2 


File Utility Overlay 


63 


FUTOV3 


File Utility Overlay 


64 


FUTOV4 


File Utility Overlay 


65 


FUTOV5 


File Utility Overlay 


66 


FUTOV6 


File Utility Overlay 


67 


FUTOV7 


File Utility Overlay 


68 


FUTOV8 


File Utility Overlay 


69 


FUTOV9 


File Utility Overlay 


6A 


FUTOVA 


File Utility Overlay 


6B 


FUTOVB 


File Utility Overlay 


A3 


QSCOMM 


DX10 HDLC Communications QSERVER 


BO 


K$EDIT 


Japan-Kanji Text Editor 


B1 


K$CMD$ 


Japan-Kanji Text Editor 


EO-EF 




Reserved 


FO-FD 




Reserved 
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Appendix D 
System Procedure IDs 



Table D-1 provides a list of the system procedure IDs. 



Table D-1. Procedure IDs 



Hexadecimal 






Code 


Name 


Purpose 


00 




Reserved 


01 


RESERVED 


Reserved for System Task 


02 


SCA 


CMD-990 System Communication Area 


03 


SCI 


CMD-990 System Command Interpreter 


04 


BCA 


CMD-990 Background Communication Area 


05 


TXDXFC 


TXDX File Conversion 


06 


DBMS 


Data Base Management System 


07 


DBINFACE 


Data Base Interface 


08 




Reserved 


09 


C$HDLC 


Industrial HDLC Procedure 


0A 


RTP 


TPL Run Time 


0B 




Reserved 


OC 


SSMODS 


S$ Routines 


0D 


SSMODSCA 


S$ Routines for Tasks with SCA 


0E 


S$OCP 


OCP Routines (after SSMODS) 


OF 


S$MODOCP 


S$/OCP Routines for System Tasks 


10 


RCOBOL 


COBOL Run Time (only to be used when 
COBOL has been installed on the system) 


11 


RPGII 
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Reserved 
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Reserved 
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Reserved 
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Reserved 
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Data Dictionary 


EO-EF 




Reserved 


FO-FD 




Reserved 
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Appendix E 
Global LUNOs 



Table E-1 provides a list of the global LUNO assignments. When the words System LUNO appear 
in parentheses beside an assignment, that means the assignment cannot be released. 

Table E-1. Global LUNO Assignments 
LUNO Assignment 

00 System Console (ST01 ) 

01 SSFGTCA — Foreground TCA File 

02 S$BGTCA — Background TCA File 

03 S$TCALIB — TCA Library File 

04 Reserved 

05 Reserved 

06 Reserved 

07 News File 

08 Reserved 

09 System Disk 

0A SSOVLYA — Overlay File (System LUNO) 

0B S$PROGA — System Program File (System LUNO) 

0C Reserved 

0D S$PROGA — System Program File (System LUNO) 

0E SSROLLA — Roll File (System LUNO) 

OF SSPROGA — System Program File (System LUNO) 

10 S$SDS$ — Languages Program File (System LUNO) 

1 1 Reserved/WT 

12 S$SLG1 — System Log File 

13 S$SLG2 — System Log File 

14 System Log Device 

15 System Log Attention Device 

16 .S$WP — Word Processing Program File 

17 .S$ODIAG.PGM — Online Diagnostics Program File 
18-20 Reserved 

21 Pascal Program File 

22 .S$COMMPF — Communications Program File 

23 DX10 RFT Program File (I) (X.25) 

24 DX10 RFT Interprocess Device (X.25) 

25 DX10 RFT Program File (II) (X.25) 
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Table E-1. Global LUNO Assignments (Continued) 



LUNO Assignment 



26 - 3F Reserved for Expansion 

40 DX10 HDLC User Program File 

90 DX10 HDLC System Program File 

91 - CF Reserved for User Files 

DO - D1 Reserved 

D2 Disk 2 

D3 Disk 3 

D4 - FF Reserved for System Assignment 
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F.1 INTRODUCTION 

This appendix helps you complete the system generation process for any installation. The exam- 
ples given here follow the format required to perform all system generations; however, the details 
for a specific installation vary with the needs of that installation. 

These examples demonstrate the terminal display generated during the execution of GEN990, the 
System Generation utility. Although system generation consists of a sequence of utilities 
(GEN990, ALGS, PGS, and IGS), only GEN990 requires extensive interaction with you. Since Sec- 
tion 3 provides examples of ALGS, PGS, and IGS commands, this appendix only provides exam- 
ples of GEN990. 

These examples copy the format that you actually see on the screen. Each line begins with a word 
or phrase followed by a question mark (?). This word or phrase is the prompt displayed by GEN990. 
Respond to the prompt by keying in an appropriate value for the prompt and pressing the Return 
key as described in Section 3. 

The prompt may be followed by an initial value in parentheses. You can accept this value by press- 
ing the Return key without entering another value. Alternatively, you can enter your own choice of 
values in the space following the initial value. 

You can respond to some prompts by simply pressing the Return key. The DX10 operating system 
supplies an appropriate default value for the parameter. If a default value is not available, the cur- 
sor remains in its location following the prompt until you enter a value. 

In these examples, some prompts are followed by responses. Other prompts are followed by an 
initial value and no other response. Still other prompts are followed by no response at all. If a 
prompt is not followed by a response, it is clear that the default value or initial value is accepted. 
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F.2 EXAMPLE ONE — FIRST TIME SYSTEM GENERATION 

In this example, suppose you want to include the following devices in your configuration: 

Two DS50 disk drives 

One733ASR 

Two 911 VDTs 

One 931 VDT 

One 940 EVT 

One 810 line printer 

In this example, an ASR is the attention device for the system log. No user-written tasks are bid 
when an IPL is performed. KIF logic is also included. The interrupt levels used are those for a 13- 
slot chassis. Note that this example does not include an expansion chassis or user-written SVCs. 

Figure F-1 shows the desired configuration for this example. The values in parentheses are the 
default values displayed by GEN990, the System Generation utility. 

Initiate system generation by issuing the XGEN command in response to the command prompt 
([ ]). The prompts for the XGEN command appear on the terminal screen: 

[]XGEN 

EXECUTE AUTO-SYSGEN 

DATA DISK/VOLUME: DS01 
INPUT CONFIGURATION: 
OUTPUT CONFIGURATION: EXAMP 

After you respond to the preceding prompts, the screen becomes clear temporarily. The remaining 
GEN990 prompts and messages appear on the terminal screen in TTY mode. 
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Figure F-1. Example 1 — Configuration Table 
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GEN990-AUTOSYSGEN RELEASE 3.6.0 

LINE? (60) 

TIME SLICING ENABLED? (YES) 

TIME SLICE VALUE? (1) 

TASK SENTRY ENABLED? (YES) 

TASK SENTRY VALUE? (60) 

TABLE? 6000 

COMMON? 

INTERRUPT DECODER? 

FILE MANAGEMENT TASKS? (2) 

CLOCK? (5) 

RESTART ID? 

OVERLAYS? (2) 

ONLINE DIAGNOSTIC SUPPORT? (NO) 

SYSLOG? (6) 

BUFFER MANAGEMENT (BYTES)? (1024) 

I/O BUFFERS? 

INTERTASK? (100) 

ITC MESSAGES? (3) 

KIF?(YES) 

COUNTRY CODE? (US) 

POWER FAIL? (NO) 

AUTO MEDIA CHANGE RECOVERY? (YES) 

SCI BACKGROUND? (2) 

SCI FOREGROUND? (8) 5 

BREAKPOINT? (16) 

PANEL DISPLAY(BAR CHART)? (YES) 

CARD1? 

CARD 2? 

NEXT?DVC 

If unsure of the proper response to a parameter, you can enter a question mark (?) and press the 
Return key for a message (similar to the one below). Messages also appear if you enter an invalid 
response. 

For example, to receive information on the DEVICE TYPE? prompt, enter a question mark in 
response and press the Return key. 

DEVICE TYPE? 
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The following information appears on the screen: 

EACH TYPE OF DEVICE OR PERIPHERAL IN YOUR SYSTEM MUST BE DEFINED. 

THE FOLLOWING MNEMONICS ARE USED: 

CRDR - CARD READER LP - LINE PRINTER 

DS — DISK VDT — VIDEO DISPLAY TERMINAL 

ASR — ASR/733 KSR — KSR 

MT - MAG TAPE COM - COMMUNICATIONS 

SD — SPECIAL DEVICE 

IF MORE THAN ONE DEVICE OF THE SAME TYPE EXISTS, EACH MUST BE DEFINED 

SEPARATELY. TO STOP ADDING DEVICES ENTER "RETURN" WHEN PROMPTED. 

After the message, continue building the system. The next set of parameters defines the two disk 
drives. The type is determined by the type of disk controller installed in the system and has no 
bearing on the system generation process. 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) 

DRIVES? (1)2 

DEFAULT RECORD SIZE? (768) 

INTERRUPT? (13) 

The next set of parameters defines an ASR: 

DEVICE TYPE? ASR 

CRU ADDRESS? 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

CASSETTE OPENS VALIDATED? (YES) 

INTERRUPT? (6) 

The next set of parameters defines the VDTs: 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) 080 
INTERRUPT? (10) 7 

DEVICE TYPE? VDT 

*** WARNING : THAT ADDRESS HAS BEEN PREVIOUSLY DEFINED *** 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

VDT TYPE? 911 

CRU ADDRESS? (> 100) 080 

INTERRUPT? (10) 3 
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DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 940 
ASSOCIATED PRINTER? (NO) 
SWITCHED LINE? (NO) 
SPEED? (1200) 
INTERFACE TYPE? CI403 
TILINE ADDRESS? (> F980) 
CHANNEL NUMBER? (0) 
INTERRUPT? (10) 11 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 931 
ASSOCIATED PRINTER? (NO) 
SWITCHED LINE? (NO) 
SPEED? (1200) 
INTERFACE TYPE? CI403 
TILINE ADDRESS? (> F980) 
CHANNEL NUMBER? (0)1 
INTERRUPT? (10) 11 

In the example, you made an error when you defined the CRU address for the second VDT. You 
correct it shortly. 

The next set of parameters defines an 810 line printer. This example and ail others that define 810 
printers assume that the extended character set is present. 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
INTERFACE TYPE? TTY/EIA 
CRU ADDRESS? (> 60) 
INTERRUPT? (14) 
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After you define all the devices, press the Return key. The System Generation utility prompts for 
another device. At this time, correct the error that you made earlier. You must correct errors before 
terminating the System Generation utility. Press the Command key. This places the System Gen- 
eration utility in command mode, and you can change or delete any device. This is the format: 

DEVICE TYPE? < Press the Command key> 

COMMAND? CHANGE 

PARAMETER TO BE CHANGED? DVC 

DEVICE NAME? ST03 

DEVICE TYPE? VDT 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

VDT TYPE? 911 

CRU ADDRESS? (> 1 00) > A0 

INTERRUPT? (10) 3 

COMMAND? 

To change a device, you must know the device name. The device in error was the second VDT 
defined, but it was the third station defined to the system (the ASR is ST01 and the first VDT is 
ST02). Hence, its device name is ST03. You can enter the LIST command when in the command 
mode to display the device names and the current parameter values for the configured system. 
Once all entities have been defined, you can terminate this system generation session. 

COMMAND? STOP 

BUILD? (YES) 

***** CONFIGURATION FILE SAVED 

***** D$DATA SOURCE FILE IS NOW BEING BUILT 

***** THE LINK EDIT COMMAND STREAM SOURCE FILE IS BEING BUILT 

***** BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT 

***** SYSGEN COMPLETE 

*****GEN990 TERMINATED *****: 



***** 
***** 
***** 
***** 
***** 



With GEN990 completed successfully, press the Command key to return to SCI. The data provided 
to GEN990 must be further processed into a form that is suitable for use by DX10. The two system 
utilities that perform this processing are as follows: 

• Assemble and Link Generated System 

• Patch Generated System 

Two more system utilities test the generated system and install it as the system that loads when- 
ever an initial program load (IPL) occurs: 

• Test Generated System 

• Install Generated System 

These utilities are initiated by SCI commands. Since they do not require extensive interaction with 
you, they are not demonstrated in these examples. Refer to Section 3 for a description of these 
utilities. 
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F.3 EXAMPLETWO — MODIFYING AN EXISTING CONFIGURATION FILE 

This example uses the configuration developed in Example One for the input configuration and 
uses it as a framework to build on. The system configuration for this example contains the 
following: 

Two DS50 disk drives 

One 820 KSR (replacing the 733 ASR) 

Four 911 VDTs (two VDTs added) 

One 931 VDT 

One 940 EVT 

One 810 line printer 

One 2260 parallel line printer (added) 

One 979A tape drive (added) 

Figure F-2 shows the desired configuration for this example. 

Initiate GEN990 by issuing the XGEN command in response to the command prompt ([ ]). The 
prompts for the XGEN command appear on the terminal screen: 



[]XGEN 

EXECUTE AUTO-SYSGEN 

DATA DISK/VOLUME 

INPUT CONFIGURATION 

OUTPUT CONFIGURATION 



DS01 

EXAMP 

EXAMP2 



After you respond to the preceding prompts, the screen becomes clear temporarily. The remaining 
GEN990 prompts and messages appear on the terminal screen in TTY mode. 

GEN990-AUTO SYSGEN RELEASE 3.6.0 

GEN990 pauses for a few seconds while it reads the input configuration file and copies it to the 
output configuration file. When ready for further input from you, GEN990 enters the command 
mode and displays the following prompt: 

COMMAND? 

To modify the system configuration of EXAMP to match that of the second example, you must 
delete the 733 ASR and add an 820 KSR. You can accomplish this in two steps, first deleting the 
ASR and, then, adding the KSR as a new device. You can also accomplish this in a single step 
using the CHANGE command. The following example demonstrates the use of the CHANGE 
command. To change, delete or add a parameter, first enter the command mode by pressing the 
Command key on your terminal. For this example, respond to the COMMAND? prompt with 
CHANGE. 
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Figure F-2. Example 2 — Configuration Table 
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COMMAND? CHANGE 

PARAMETER TO BE CHANGED? DVC 

DEVICE NAME? ST01 

DEVICE TYPE? KSR 

DSR TYPE(TPD/KSR/K820)? TPD 

TERMINAL TYPE? (743) 820 

INTERFACE TYPE? 9902 

SWITCHED LINE? (NO) 

BAUD RATE? (300) 4800 

ACU PRESENT? (NO) 

FULL DUPLEX MODEM? (YES) 

ECHO? (YES) 

CRU ADDRESS? (> 00) 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

INTERRUPT? (6) 

COMMAND? 



Next, you must add the two 911 VDTs. Enter the inquire mode by entering INQUIRE in response to 
the COMMAND? prompt. 

COMMAND? INQUIRE 
NEXT? DVC 
DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) 
INTERRUPT? (10) 
DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) 0120 
INTERRUPT? (10) 8 

This example stops GEN990 at this point to demonstrate that a configuration need not be com- 
pleted in one session. However, you must direct GEN990 to save the configuration file if you want 
to preserve the data that has been entered. 
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DEVICE TYPE? < Press the Command key> 

COMMAND? STOP 

BUILD? (YES) NO 

DO YOU WANTTO SAVE THE CONFIGURATION FILE? (NO) YES 

***** CONFIGURATION FILE SAVED ***** 

***** SYSGEN COMPLETE ***** 

***** GEN990 TERMINATED *****: 

When you want to finish defining the devices in this system, reenter GEN990 as shown below. 
Note that the input configuration is EXAM2. 

[]XGEN 

EXECUTE AUTO-SYSGEN 

DATA DISK/VOLUME: DS01 
INPUT CONFIGURATION: EXAM2 
OUTPUT CONFIGURATION: EXAM2 

GEN990 SYSTEM GENERATION DX10 3.6.0 

GEN990 pauses for a few seconds while it reads the input configuration file and copies it to the 
output configuration file. When ready for further input from you, GEN990 enters the command 
mode and displays the following prompt: 

COMMAND? 

The only devices that you still must define are the additional line printer and the magnetic tape 
drive. 

COMMAND? INQUIRE 

NEXT?DVC 

DEVICE TYPE? LP 

ACCESS TYPE? (FILE) 

PRINT MODE? (SERIAL) PARALLEL 

EXTENDED? (YES) 

TIME OUT? (60) 

CRU ADDRESS? (> 60) > 40 

INTERRUPT? (14) 4 
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DEVICE TYPE? MT 

TILINE ADDRESS? (> F880) 

DRIVES? (1) 

INTERRUPT? (9) 

DEVICE TYPE? < Press the Command key> 

COMMAND? STOP 

BUILD? (YES) 

***** CONFIGURATION FILE SAVED ***** 

***** D$DATA SOURCE FILE IS NOW BEING BUILT ***** 

***** THE LINK EDIT COMMAND STREAM SOURCE FILE IS BEING BUILT ***** 

***** BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT * 

*****SYSGEN COMPLETE ***** 

***** GEN990 TERMINATED *****: 

This configuration is now complete and ready to be assembled and linked, patched, tested, and 
installed. 



F.4 EXAMPLE THREE — DEFINING SPECIAL DEVICES 

This example demonstrates the definition of a special device. This example is not associated with 
the previous configuration charts. You must supply the device service routine (DSR) for the device 
and a physical device table (PUT). Refer to Section 5 for details on DSRs and PDTs. 

DEVICE TYPE? SD 
INTERFACE TYPE? (NONE) 
SPECIAL DEVICE ADDRESS? (> 100) 
DEVICE NAME? PL01 
INTERRUPT BIT? (15) 
KSB ADDRESS? (NONE) 
DSR WORKSPACE? DSRPIO 
INTERRUPT ENTRY? PLINT 
PDT FILE? .S$SYSGEN.PLPDT01 
DSR FILE? .S$SYSGEN.PLDSR 
OVERRIDE? YES 
INTERRUPT? (15) 10 
NEXT?DVC 

If the device contains a keyboard, GEN990 names it using the ST prefix according to how it named 
all previous keyboard devices. However, this is not a keyboard device; it is a plotter device. 
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The next example shows how to define a second plotter: 

DEVICE TYPE? SD 

INTERFACE TYPE? (NONE) 

SPECIAL DEVICE ADDRESS? (> 100) > 120 

DEVICE NAME? PL02 

INTERRUPT BIT? (15) 

KSB ADDRESS? (NONE) 

DSR WORKSPACE? DSRPIO 

INTERRUPT ENTRY? PLINT 

PDT FILE? .S$SYSGEN.PLPDT02 

DSR FILE? .S$SYSGEN.PLDSR 

OVERRIDE? YES 

INTERRUPT? (15) 10 

A special device can be a TILINE device. The following example displays the portion of the System 
Generation utility required to define two special TILINE devices, with device names SS01 and 
SS02: 

DEVICE TYPE? SD 

INTERFACE TYPE? (NONE) 

SPECIAL DEVICE ADDRESS? (> 100) > F850 

DEVICE NAME? SS01 

INTERRUPT BIT? (15) 

KSB ADDRESS? (NONE) SSKSB01 

DSR WORKSPACE? DSRSIO 

INTERRUPT ENTRY? SSINT 

PDT FILE? .S$SYSGEN.SSPDT01 

DSR FILE? .S$SYSGEN.SSDSR 

OVERRIDE? YES 

INTERRUPT? (15) 

DEVICE TYPE? SD 

INTERFACE TYPE? (NONE) 

SPECIAL DEVICE ADDRESS? (> 100) > F860 

DEVICE NAME? SS02 

INTERRUPT BIT? (15) 

KSB ADDRESS? (NONE) SSKSB02 

DSR WORKSPACE? DSRSIO 

INTERRUPT ENTRY? SSINT 

PDT FILE? .S$SYSGEN.SSPDT02 

DSR FILE? .S$SYSGEN.SSDSR 

OVERRIDE? YES 

INTERRUPT? (15) 14 
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F.5 EXAMPLE FOUR — DEFINING AN EXPANSION CHASSIS 

This example describes the steps required to perform a system generation for an installation that 
requires at least one expansion chassis. This example also describes the inclusion of the 3780 
communications emulator with an auto-call unit (ACU). The system configuration for this example 
includes the following: 

Two DS50 disk drives 

One DS10 disk drive 

One FD1000 double-sided, double-density (DSDD) flexible diskette 

One 979A tape drive 

One communications interface board with 3780 protocol 

Two 810 line printers 

One 2260 line printer 

One 733 KSR 

Seven 911 VDTs 

Two 820 KSRs 

Two special devices 

Figure F-3 shows the devices as they are configured in the main chassis (a 17-slot chassis in this 
example). Figure F-4 is the configuration chart for the expansion chassis. 

The steps for defining this configuration are as follows: 

Initiate system generation by issuing the XGEN command in response to the command prompt 
([ ]). The prompts for the XGEN command appear on the terminal screen: 



UXGEN 

EXECUTE AUTO-SYSGEN 



DATA DISK/VOLUME 

INPUT CONFIGURATION 

OUTPUT CONFIGURATION 



DS01 
EXAM4 



After you respond to the preceding prompts, the screen becomes clear temporarily. The remaining 
GEN990 prompts and messages appear on the terminal screen in TTY mode. 
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Figure F-3. Example 4 — Main Chassis 
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Figure F-4. Example 4 — Expansion Chassis 
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GEN990-AUTOSYSGEN RELEASE 3.6.0 

LINE? (60) 

TIME SLICING ENABLED? (YES) 

TIME SLICE VALUE? (1) 

TASK SENTRY ENABLED? (YES) 

TASK SENTRY VALUE? (60) 

TABLE? 8000 

COMMON? 

INTERRUPT DECODER? 

FILE MANAGEMENT TASKS? (2) 

RESTART ID? 

OVERLAYS? (2) 

ONLINE DIAGNOSTIC SUPPORT? (NO) 

SYSLOG? (6) 

BUFFER MANAGEMENT (BYTES)? (1024) 

I/O BUFFERS? 

INTERTASK? (100) 

ITC MESSAGES? (3) 

KIF?(YES) 

COUNTRY CODE? (US) 

POWER FAIL? (NO) 

AUTO MEDIA CHANGE RECOVERY? (YES) 

SCI BACKGROUND? (2) 

SCI FOREGROUND? (8) 10 

BREAKPOINT? (16) 

PANEL DISPLAY(BAR CHART)? (YES) 

CARD 1? 10 

CARD 2? 

NEXT?DVC 

ENTITY? DVC 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) 

DRIVES? (1)2 

DEFAULT RECORD SIZE? (768) 

INTERRUPT? (13) 15 

DEVICE TYPE? MT 
TILINE ADDRESS? (> F880) 
DRIVES? (1) 
INTERRUPT? (9) 12 

The next disk drive to be defined is the DS10. (Refer to Figure F-3.) Note that a DS10 disk drive 
consists of two drives that share a single cabinet and a single interface to a single controller 
board. GEN990 treats each drive as a separate logical device. 
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DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) > F820 

DRIVES? (1)2 

DEFAULT RECORD SIZE? (768) 288 

INTERRUPT? (13) 8 

The next device is the Model FD1000 flexible diskette drive. 

DEVICE TYPE? DS 

TILINE ADDRESS? (> F800) > F840 

DRIVES? (1)2 

DEFAULT RECORD SIZE? (768) 256 

INTERRUPT? (13) 3 

DEVICE TYPE? ASR 

CRU ADDRESS? 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

CASSETTE OPENS VALIDATED? (YES) 

CASSETTE ACCESS TYPE? (FILE) 

INTERRUPT? (6) 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
INTERFACE TYPE? TTY/EIA 
CRU ADDRESS? (> 60) > 40 
INTERRUPT? (14) 4 

DEVICE TYPE? LP 
ACCESS TYPE? (FILE) 
PRINT MODE? (SERIAL) 
EXTENDED? (YES) 
SPEED? (4800) 
TIME OUT? (60) 
INTERFACE TYPE? TTY/EIA 
CRU ADDRESS? (> 60) 
INTERRUPT? (14) 

DEVICE TYPE? LP 

ACCESS TYPE? (FILE) 

PRINT MODE? (SERIAL) PARALLEL 

EXTENDED? (YES) 

TIME OUT? (60) 

CRU ADDRESS? (> 60) > 180 

INTERRUPT? (14) 13 
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You must define the communications emulators being used. Enter the interrupt level and CRU or 
TILINE address associated with the communications board. You do not need to define the ACU or 
the modem associated with this device during GEN990's execution. Define the ACU and the asso- 
ciated 3780 emulator after executing GEN990 and before assembling and linking the generated 
system (ALGS) as part of the emulator's software installation. (Consult the appropriate emulator 
object installation guide.) The modem is in the chassis at this time for the sake of convenience 
only. The modem does not receive power until it is physically connected to an ACU and even then 
its presence is transparent to the operating system. 

DEVICE TYPE? COM 
COM DEVICE ADDRESS? > 80 
NUMBER OF CHANNELS? (1) 
CHANNEL NUMBER 00 PROTOCOL? 3780 
BUFFER SIZE? (528) 

Since all of the 820s are installed in the expansion chassis, the interrupt level assigned to each is 
the same The parameter EXPANSION POSITION refers to the position or interrupt level asso- 
ciated with the device in the expansion chassis. The DSR type is specified as TPD although it 
could be the K820 DSR. Refer to the note in paragraph 3.4.5.6 for a discussion of the available 
DSRs. The following examples define the 820 KSRs: 

DEVICE TYPE? KSR 
DSR TYPE(TPD/KSR/K820)? TPD 
TERMINAL TYPE? (743) 820 
INTERFACE TYPE? CI401 
SWITCHED LINE? (NO) 
BAUD RATE? (300) 1200 
ACU PRESENT? (NO) YES 
ACU CRU? (0)> 0160 
FULL DUPLEX MODEM? (YES) 
ECHO? (YES) 

CRU ADDRESS? (> 00) > 0520 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
INTERRUPT? (6) 10 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 8 
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DEVICE TYPE? KSR 

DSR TYPE(TPD/KSR/K820)? TPD 

TERMINAL TYPE? (743) 820 

INTERFACE TYPE? CI401 

SWITCHED LINE? (NO) 

BAUD RATE? (300) 1200 

ACU PRESENT? (NO) 

FULL DUPLEX MODEM? (YES) 

ECHO? (YES) 

CRU ADDRESS? (> 00) > 0500 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

INTERRUPT? (6) 10 

EXPANSION CHASSIS? 1 

EXPANSION POSITION? 10 

DEVICE TYPE? KSR 

DSR TYPE(TPD/KSR/K820)? TPD 

TERMINAL TYPE? (743) 820 

INTERFACE TYPE? TTY/EIA 

SWITCHED LINE? (NO) 

BAUD RATE? (300) 

ACU PRESENT? (NO) 

FULL DUPLEX MODEM? (YES) 

ECHO? (YES) 

CRU ADDRESS? (> 00) > 0400 

ACCESS TYPE? (RECORD) 

TIME OUT? (0) 

CHARACTER QUEUE? (6) 

INTERRUPT? (6) 10 

EXPANSION CHASSIS? 1 

EXPANSION POSITION? 6 

Since all of the VDTs are installed in the expansion chassis, the interrupt level assigned to each is 
the same. The parameter EXPANSION POSITION refers to the position or interrupt level asso- 
ciated with the device in the expansion chassis. 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 420 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 15 
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DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 440 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 4 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 460 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 14 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 480 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 7 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 4A0 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 3 

DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 4C0 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 11 
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DEVICE TYPE? VDT 
ACCESS TYPE? (RECORD) 
TIME OUT? (0) 
CHARACTER QUEUE? (6) 
VDT TYPE? 911 
CRU ADDRESS? (> 100) > 4E0 
INTERRUPT? (10) 
EXPANSION CHASSIS? 1 
EXPANSION POSITION? 12 

The special devices are defined last in this example, but you can define them any time during the 
system generation process. 

DEVICE TYPE? SD 

INTERFACE TYPE? (NONE) 

SPECIAL DEVICE ADDRESS? (> 100) > 540 

DEVICE NAME? EM01 

INTERRUPT BIT? (15) 

KSB ADDRESS? (NONE) 

DSR WORKSPACE? PSEM01 

INTERRUPT ENTRY? EMINT 

PDT FILE? .S$SYSGEN.EMPDT 

DSR FILE? .SSSYSGEN.EMDSR 

OVERRIDE? YES 

INTERRUPT? (15) 10 

EXPANSION CHASSIS? (1) 

EXPANSION POSITION? (0) 9 

DEVICE TYPE? SD 

INTERFACE TYPE? (NONE) 

SPECIAL DEVICE ADDRESS? (> 100) > 580 

DEVICE NAME? TM01 

INTERRUPT BIT? (15) 

KSB ADDRESS? (NONE) 

DSR WORKSPACE? PSTM01 

INTERRUPT ENTRY? TMINT 

PDT FILE? .SSSYSGEN.TMPDT 

DSR FILE? .S$SYSGEN.TMDSR 

OVERRIDE? YES 

INTERRUPT? (15) 10 

EXPANSION CHASSIS? (1) 

EXPANSION POSITION? (0) 9 

Once all devices and user-written software are included, the configuration is complete. You can 
now terminate the System Generation utility. 
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DEVICE TYPE? < Press the Command key> 

COMMAND? STOP 

BUILD? (YES) 

***** CONFIGURATION FILE SAVED 

***** D$DATA SOURCE FILE IS NOW BEING BUILT 

***** THE LINK EDIT COMMAND STREAM SOURCE FILE IS BEING BUILT 

***** BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT 

***** SYSGEN COMPLETE 

***** GEN990 TERMINATED *****: 

With successful execution of GEN990, the remaining steps of system generation are assembling 
and linking, patching, testing, and installing the system. Refer to Section 3 for instructions and 
examples of these steps. 



***** 
***** 
***** 
***** 
***** 
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SVC Codes 



Table G-1 contains a list of the codes associated with the calls used in DX10. 



Table G-1. SVC Codes 







Call Block 




Hexadecimal 


Length (Bytes) 


Call 


Code 


Decimal 




I/O Calls 




Perform I/O Operation 


00 


14 


Wait for I/O 


01 


4 


Wait for Multiple Initiate i/Os 


36 


4 


Get Event Character 


30 


4 


Abort I/O 


OF 


2 


Get Event Character by LUNO 


39 


4 


File Utility Request 


15 
Program Control Calls 


24 


Execute Task 


2B 


12 


Activate Suspended Task 


07 


3 


Scheduled Bid Task 


1F 


14 


Load an Overlay 


14 


7 


End of Task 


04 


1 


End of Program 


16 


1 


Time Delay 


02 


4 


Change Priority 


11 


2 


Poll Status of Task in Terminal Task Set 35 


8 


Unconditional Wait 


06 


1 


Activate Time Delay Task 


0E 


3 


Get Parameters 


17 


6 


Self Identification 


2E 


6 


End Action Status 


2F 


10 


Reset End Action 


3E 


4 


Map Program Name to ID 


31 


16 


Bid Task 


05 


8 


Do Not Suspend 


09 


2 



946250-9705 



G-1 



SVC Codes 



Table G-1 . SVC Codes (Continued) 



Call 



Hexadecimal 
Code 



Call Block 

Length (Bytes) 

Decimal 



Memory Control Calls 



Get Memory 

Release Memory 

Get Common Data Address 

Return Common Data Address 



Getdata 

Putdata 

Date and Time 

System Log 

Retrieve System Information 



Convert Binary to Decimal 
Convert Decimal to Binary 
Convert Binary to Hexadecimal 
Convert Hexadecimal to Binary 



Miscellaneous Calls 



12 
13 
10 
1B 



1D 
1C 
03 
21 
3F 



Data Conversion Calls 



0A 
OB 
0C 
0D 



Privileged Supervisor Calls 



Install Task 

Install Procedure 

Install Overlay 

Delete Task 

Delete Procedure 

Delete Overlay 

Kill Task 

Suspend Awaiting Queue Input 

Read/Write TSB 

Read/Write Task 

Get System Pointer Table Address 

Initialize Date and Time 

Disk Manager 

Assign Space on Program File 

Initialize New Volume 

Install Disk Volume 

Unload Disk Volume 

Direct Disk I/O 



25 
26 
27 
28 
29 
2A 
33 
24 
2C 
2D 
32 
3B 
22 
37 
38 
20 
34 
00 



12 

12 

8 

7 

6 



20 

16 

18 

6 

6 

6 

8 

1 



40 

6 

6 

14 

10 

24 

14 

14 

16 
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Bidding a Task from a DSR 



The following Is an example of task bidding from a device service routine (DSR). It should be 
emphasized that this is an example only. The 913 VDT does not have this capability programmed 
into it. This is to illustrate some of the problems encountered in programming a DSR to have tasks 
bid from it and to reach a possible solution. 

This specific example shows how a task installed as task > 99 on the system program file would 
be bid whenever the command key F4 is pressed on the keyboard of a 913 VDT. Since several 
registers are needed to call the subroutine TMBIDO, a context switch was performed using the 
Scheduler Stack (SHDSTK) as the workspace. The Scheduler Stack also provided the necessary 
stack area for the call to subroutine TMBIDO. Bit 7 of the device status flags in the physical device 
table (PDT) was used as an indicator that a task bid is in progress. It is not recommended that this 
bit be used, as this bit is reserved to be defined in future releases of DX10. A feasible solution 
would be to define an additional word in the PDT when writing the DSR. This can be used as a flag 
word. 

One problem that must be addressed is the handling of multiple requests to bid a task before a 
previous bid is complete. In this example, while the Bid Task in Progress flag is set, ail subsequent 
requests to bid a task are ignored. 
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DSR913 - CRT 913 HANDLER 



11:38:31 WEDNESDAY, JUL 05, 1978. 

PAGE 0037 



1165 
1166 
1167 
1168 
1169 
1170 
1171 
1172 
1173 



1174 
1175 
1176 
1177 
1178 
1179 
1180 
1181 
1182 
1183 
1184 
1185 
1186 
1187 
1188 
1189 
1190 
1191 
1192 
1193 
1194 
1195 
1196 
1197 
1198 
1199 
1200 
1201 
1202 
1203 
1204 
1205 

1206 

1207 
1208 
1209 



0670 
0670 
0672 
0674 



C924 
FFFA 
FFFC 



0676 
0678 
067A 
067C 
067E 
0680 
0682 
0684 

0686 
0688 



C1C2 

0A87 

1709 

0207 

0000 

0208 

0696' 

0407 

0620 
0000 



*$0=0=0=»0=0=0»0=0=0»0=0=0=0-0»0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 

* ABSTRACT : 

* TDI913 - ENTRY POINT FOR TIMER DSR AND KBI'S. 

* R6 CONTAINS THE INTERRUPT VECTOR. 

*$0«0-0»0»0«0*0-0-0-0-0-0-0»0-0-0»0-0»0»0»0»0»0=0»0»0=0»0=0 

* 

TDI913 

MOV @PDT$Ml ( 4 ) , @PDT$M2 ( 4 ) LET TIMEOUT- RESET 

*********************************************************** 
* 

* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 

************************************************************ 

TM$ROT - BID TASK 

GLOBAL VARIABLE 

SCHEDULER STACK 

GLOBAL BID TASK FLAG 

ACTIVATE SCHEDULER FLAG 

TIME SLICE EXTENDED FLAG 

SET FLAGS 

BID IN PROGRESS? 

NO - CONTINUE 

YES-USE SCHEDULER STACK AS WSP 

SET UP PROGRAM COUNTER 

PERFORM CONTEXT SWITCH 
RETURN FROM CONTEXT SWITCH 
RESET GLOBAL BID IN PROGRESS 



ABSTRACT : 

BIDTASK - THIS ROUTINE WILL BID A SPECIFIED TASK 
FROM THE DSR. TDI913 IS THE RE-ENTER ME VECTOR IN 
THE DSR. THIS ROUTINE CHECKS FOR A BID IN PROGRESS. 
IF THERE IS ONE, A CONTEXT SWITCH IS PERFORMED 
IN ORDER TO GAIN THE NECESSARY REGISTERS FOR THE 
CALL TO SUBROUTINE 'TMBIDO'. THE SCHEDULER STACK 
IS USED FOR A WORKSPACE. 

AFTER THE CONTEXT SWITCH IS PERFORMED, A 
STACK IS SET UP FOR THE SUBROUTINE CALL. THEN THE 
PARAMETER FOR THE CALL TO 'TMBIDO' IS SET AND THE 
SUBROUTINE IS CALLED. 

IF THERE IS AN ERROR, THE ERROR IS REPORTED 
TO THE LOG. (NOTE: ERROR PROCESSING IS DEPENDENT ON 
THE APPLICATION) . IN EITHER ERROR OR NORMAL RETURN 
A RETURN FROM THE CONTEXT SWITCH IS PERFORMED, THE 
BID IN PROGRESS FLAG IS RESET, AND NORMAL PROCESSING 
IS RESUMED. 



REF 


TMBIDO 


REF 


BYTEOl 


REF 


SHDSTK 


REF 


BIDTSK 


REF 


TM$DFR 


REF 


TMESLC 


MOV 


R2,R7 


SLA 


R7,8 


JNC 


TD12 


LI 


R7 , SHDSTK 


LI 


R8,BIDl 


BLWP 


R7 


DEC 


QBIDTSK 
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1210 

1211 
1212 
1213 

1214 
1215 
1216 
1217 
1218 

1219 

1220 
1221 
1222 

1223 
1224 

1225 

1226 
1227 
1228 
1229 
1230 

1231 

1232 

1233 
1234 
1236 
1237 
1238 
1239 
1240 
1241 
1242 
1243 
1244 
1245 
1246 
1247 
1248 
1249 
1250 
1251 



068A 
068C 

068E 
0690 
0692 
0694 



0696 
0698 
069A 
069C 
069E 
06A0 
06A2 
06A4 
06A6 
06A8 
06AA 
06 AC 
06AE 
06B0 
06B2 
06B4 

06B6 
06B8 
06BA 
06BC 
06BE 
06C0 
06C2 

06C4 



50A0 

0000 

068E' 

C2C6 

0206 

04F4" 

045B 

0696' 

02AA 

022A 

0020 

0201 

9900 

04C2 

04C3 

C16D 

0008 

04C4 

D125 

000D 

06A0 

0000 

06B6" 

1007 

06B6' 

06C0 

O940 

FFEO 

04E5 

FFE6 

04E5 

FFE8 

06C4' 

0380 
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SZCB @BYTE01,R2 RESET LOCAL BID IN PROGRESS 



TDI2 EQU $ 

MOV R6,Rll 

LI R6,IDL913 

BYTE04 B *Rll 

* 

BIDl EQU $ 

STWP RIO 

AI Rl0,32 



BID2 



SAVE VECTOR 
SET NEW VECTOR 

GO TO INTERRUPT ROUTINE 



LI Rl,>9900 

CLR R2 
CLR R3 
MOV @8(R13) ,R5 

CLR R4 

MOVB @KSBSN(5) ,R4 

BL 8TMBIDO 

DATA BID2 

JMP BID4 

EQU $ 

SWPB R0 

MOVB R0,@PDT$RR(R5) 

CLR @PDT$L1(R5) 

CLR @PDT$L2(R5) 



SET UP STACK 

IN FREE PART OF SCHEDULER ST 

INSTALLED TASK ID 

BID PARM 1 
BID PARM 2 
GET KSB ADDRESS 



STATION NUMBER 

BID TASK 

ERROR RETURN 
NORMAL RETURN 
ERROR PROCESSOR 

SET UP ERROR CODE 

SET SYSTEM LOG INFO 



BID4 EQU $ 

RTWP 
*$0»0=0=0=0=0*0»0=0=0=0»0«0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 

* ABSTRACT : 

* KBI913 - THIS IS THE ROUTINE TO HANDLE KEYBOARD 

* INTERRUPTS. THE DATA IS FETCHED FROM THE 

* KEYBOARD INPUT LINES. THE DATA IS MAPPED 

* INTO A STANDARD SET OF CHARACTER CODES FOR 

* THE TASKS USING THIS DEVICE. EVENT CHARACTERS 

* ARE PLACED IN THE EVENT BUFFER. DATA 

* CHARACTERS ARE PLACED IN THE DATA BUFFER. 

* SPECIAL EVENT CHARACTERS ARE SCREENED WHEN 

* THE FLAG FOR THOSE IS SET. THE FLAG FOR THE 

* COMMAND INTERPRETER IS SET WHEN THAT EVENT IS 

* RECOGNIZED. 

* 

*$0»0=0=0=0=sO=0=0=0=0=0=0=0=0=0==0=0=0=0=0=0=0=0=0=0=0=0=0=0=0 
* 
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1252 
1253 
1254 
1255 
1256 
1257 

1258 
1259 
1260 
1261 
1262 
1263 
1264 
1265 
1266 
1267 
1268 
1269 
1270 
1271 
1272 

1273 
1274 
1275 

1276 
1277 
1278 



1279 

1280 

1281 
1282 

1283 
1284 
1285 
1286 
1287 

1288 



1289 



06C6 
06C6 
06C8 
06CA 
06CC 
06CE 
06D0 
06D2 



06D4 
06D6 
06D8 
06DA 
06DC 
06DE 
06E0 
06E2 
06E4 
06E6 
06E8 
06EA 
06EC 
06EE 
06F0 
06F2 
06F4 
06P6 



06F8 
06FA 
06FC 
06FE 
0700 
0702 
0704 
0706 
0708 



KBI913 



04CA 
35CA 
1F14 
1602 
020A 
7F00 
1D11 



028A 

7500 

160F 

C250 

C1E9 

0008 

0A87 

180A 

FA60 

068C' 

0008 

05A0 

0688' 

C1E0 

0000 

1602 

0720 

0000 

06F8' 

C186 

1131 

06A0 

0000 

700D 

6100 

0754' 

028A 

3F00 



CLR RIO 

STCR RIO , 7 

TB KBPERR-8 

JNE KBIC 

LI RlO, 7F00 



ENTER INTO CHAR (7-BIT) 
IF PARITYERR EQ 1 THEN 

LET CHAR-DELETE 



END 



KBIC SBO KBACK-8 I ACK INTERRUPT 

*********************************************************** 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

*********************************************************** 



CHECK FOR BID TASK INTERRUPT 

AT THIS POINT, A CHECK IS MADE TO SEE IF THE *F4* 
HAS BEEN TYPED IN, INDICATING THAT TASK 99 IS TO BE 
BID UP. THE 'F4' KEY SENDS AN ASCII CODE OF 75. 

A CHECK IS MADE TO SEE IF A BID TASK IS ALREADY 
IN PROGRESS. IF SO, THIS REQUEST IS IGNORED. (NOTE: 
HANDLING OF MULTIPLE BID TASK REQUESTS ON THE SAME 
DEVICE IS APPLICATION DEPENDENT) . OTHERWISE, THE 
LOCAL AND GLOBAL TASK FLAGS ARE SET. SCHEDULING 
IF FORCED IF POSSIBLE. 



CI R10, 7500 



BID TASK REQUESTED? 



JNE KBIB NO - CONTINUE 

MOV *R0,R9 NES-WORKSPACE POINTER (PDT ADDR 

MOV @PDTDSF(R9) ,R7 BID TASK ALREADY IN PROGRESS? 

SLA R7 ,8 

JOC KBIB YES - IGNORE THIS REQUEST 

SOCB <§BYTE01,@PDTDSF(R9)NO - SET LOCAL BID TASK FLA 



INC (3BIDTSK SET GLOBAL BID TASK FLAG 

MOV @TMESLC,R7 TIME SLICE EXTENDED OF EXECUTING 



JNE KBIB 
SETO @TM$DFR 



TASK? YES, CONTINUE 

NO, FORCE SCHEDULING NOW 



************************************************************* 

KBIB EQU $ 

MOV R6 , R6 

JLT KBIW 

BL QKEYFUN CALL KEYFUN (R10 , RESET, KILL, 



IF NOT IN CHARACTER MODE 



DATA >700D,>6100,KBIU 



BID,00,KBIU) 



CI R10,>3F00 



IF CHAR LT 3F THEN 
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1290 


070A 


1BOB 




JH 


KBII 




1291 


070C 
070E 


0209 
FFDC 




LI 


R9,-LOWEND-2 


LET COUNT=-LOWEND-2 


1292 


0710 


05C9 


KBIF 


INCT 


R9 


REPEAT LET COUNT=COUNT+2 


1293 


0712 


130E 




JEQ 


KBIL 


UNTIL COUNT EQ O 


1294 


0714 


92A9 




CB 


QMAPLOW+LOWEND ( 9 ) , R10 IF MAPLOW (COUNT ) EQ CHAR 




0716 


0796' 










1295 


0718 


1BOB 




JH 


KBIL 




1296 


071A 


16FA 




JNE 


KBIF 




1297 


071C 


D2A9 




MOVB 


@MAPLOW+LOWEND+l(9) ,R10 LET CHAR-MAP LOW (COUNT) 




071E 


0797' 










1298 


0720 


1007 




JMP 


KBIL 


END 


1299 


0722 
0724 


028A 
5A00 


KBII 


CI 


Rl0,>5A00 


EL IF CHAR GT 5 A THEN 


1300 


0726 


1204 




JLE 


KBIL 




1301 


0728 


C24A 




MOV 


RlO,R9 


LET CHAR= REMAP (CHAR) 


1302 


072A 


0989 




SRL 


R9,8 




1303 


072C 
072E 


D2A9 
073C' 




MOVB 


@REMAP->5B(9) , 


,R10 END END 


1304 


0730 
0732 


028A 
7F00 


KBIL 


CI 


R10,>7F00 


IF CHAR GT CLEAR 


1305 


0734 


120 A 




JLE 


KBIO 




1306 


0736 
0738 


028A 
8800 




CI 


Rl0,LO$EDT 


AND (CHAR LT LO$EDT) 


1307 


073A 


1A03 




JL 


KBIM 




1308 


073C 
073E 


028A 
9500 




CI 


R10,HI$EDT 


OR CHAR GT HI$EDT) THEN 


1309 


0740 


1204 




JLE 


KB10 




1310 


9742 
0744 


06A0 
0000 


KBIM 


BL 


QPUTEBF 


CALL PUTEBF(R10,ERR=KBIR) END 


1311 


0746 


0752' 




DATA 


KBIR 


!PUT CHAR IN EVENT BUFFER 


1312 


0748 


1005 




JMP 


KBIU 


END 


'1313 


074A 
074C 


06A0 
0000 


KBIO 


BL 


QPUTCBF 


CALL PUTCBF(RIO) 


1314 


074E 


0752' 




DATA 


KBIR 


!PUT CHAR IN DATA BUFFER 


1315 


0750 


1001 




JMP 


KBIU 




1316 


0752 


1D07 


KBIR 


SBO 


BEEEEP-8 


DISPLAY .BEEP 


1317 


0754 


C250 


KBIU 


MOV 


*R0,R9 


CALL DSR 


1318 


0756 


FA60 




SOCB 


@BYTE04,@PDTDSF(9) !SET RE-ENTER-ME FLAG 




0758 


0694' 












075A 


0008 










1319 


075C 


0380 


KBIZ 


RTWP 




RETURN 


1320 






* 








1321 




075E' 


KBIW 


EQU 


$ 




1322 


075E 
0760 


06A0 
0000 




BL 


@CMODE 


CALL CHARACTER MODE ROUTINE 


1323 


0762 


0752' 




DATA 


KBIR 




1324 


0764 


10F7 




JMP 


KBIU 
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1326 






1327 






1328 






1329 






1330 






1331 






1332 






1333 






1334 




0766' 


1335 


0766 


C28A 


1336 


0768 


C28A 


1337 


076A 


C2 8A 


1338 


076C 


C28A 


1339 


076E 


C28A 


1340 


0770 


C2 8A 


1341 






1342 


0772 


045B 


1343 






1344 


0774 


028C 




0776 


0888 




0778 


0989 




077A 


0A8A 


1345 


077C 


0D8D 




077E 


1A95 




0780 


1C92 




0782 


233A 


1346 


0784 


243C 




0786 


262F 




0788 


2F3F 




078A 


3A3B 


1347 


078C 


3B8B 




078E 


3C7F 




0790 


3D91 




0792 


3E90 


1348 


0794 


3F5E 


1349 




0022 


1350 


0796 


00 


1351 


0797 


8F 




0798 


94 




0799 


8E 




079A 


00 




079B 


00 


1352 


079C 


40 




079D 


21 




079E 


22 




079F 


23 




07A0 


24 




07A1 


3D 




07A2 


26 




07 A3 


27 



•=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0=0= 

* WAIT : 

* THIS ROUTINE DOES THE TIMING LOOP FOR ALL 

* CURSOR MOVES AND STROBES. IF THIS IS A 

* /10 MACHINE, THE POWER UP CODE WILL MODIFY 

* THE ROUTINE BY PLACING THE RT INSTRUCTION 

* AT THE START OF THE MODULE. 

*»0=0 =0=0 =0=0 =0=0=0=0=0=0=0=0=0»Q=0=0=0=0=0=0=0 =0=0=0 =«0=0=0= 
WAIT EQU $ 

MOV Rl0,Rl0 TIMING LOOP,l INSTR=550 NANOS 

MOV R10, R10 

MOV R10, R10 

MOV R10,R10 

MOV R10,R10 

MOV R10, R10 
*NOTE: THE RETURN WILL BE MOVED AFTER "WAIT" ON THE /10 

WAITRT RT 
* 

MAPLOW DATA >028C, >0888 , >0989 , >0A8A 



DATA >0D8D,>1A95,>1C92,>233A 



DATA >243C,>262F,>2F8F,>8A8B 



DATA >3B8B,>3C7F,>3D91,>3E90 



DATA >3F5E 
LOWEND EQU $-MAPLOW 

BYTE 00 
REMAP BYTE 



>8F,>94,>8E,>00,>00 5B - 5F 



BYTE >40,>21,>22,>23,>24,>3D,>26,>27 60 - 67 
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BYTE >28, >29, >2A, >3E,>00, >00 f >00,>00 68 - 6F 



1353 


07A4 


28 




07A5 


29 




07A6 


2A 




07A7 


3E 




07A8 


00 




07A9 


00 




07AA 


00 




07AB 


00 


1354 


07 AC 


9B 




07AD 


80 




07AE 


81 




07AP 


82 




07B0 


83 




07B1 


84 




07B2 


85 




07B3 


86 


1355 


07B4 


96 




07B5 


98 




07B6 


9E 




07B7 


9P 




07B8 


93 




07B9 


99 




07BA 


00 




07BB 


7P 


1357 






NO ERRORS 





BYTE >9B r >80 r >81,>82 r >83 f >84,>85,>86 70 - 77 



BYTE >96,>98, >9E, >9F, >93 , >99 , >00,>7F 78 - 7F 



END 
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DX10 Memory Estimator 



1.1 INTRODUCTION 

This appendix contains the DX10 memory estimator and an explanation of the entries of the mem- 
ory estimator. This appendix concludes with a paragraph of hints on determining the number of 
terminals that a particular generated system can support. 

The memory estimator and accompanying material are guides to aid in configuring a system. Cau- 
tions are provided about terminal capacity and application's requirements; the final test is 
whether the system can be successfully generated and run. Results derived from the memory esti- 
mator should not be construed as an assurance by Texas Instruments that a given configuration 
will or will not work. 



I.2 DX10 MEMORY ESTIMATOR 

The memory estimator is used for four purposes: 

• To estimate the total physical memory requirements of a system. 



• 



To determine that the logical address space requirements for a given configuration do 
not exceed > F800. 



• To determine that the system root does not exceed 48K bytes in size. 

• To estimate system table area capacity and requirements. The DX10 Memory Estimator 
is a tool to aid the calculation of a system's total length and the allocation of system 
memory in terms of operating system overhead and space for application programs. 

Advance through the items of the memory estimator entering values that reflect your system's 
configuration. The SIZE column gives the size of an item used by DX10. The QTY column is avail- 
able for you to write in how many of a particular thing you have in your system. If a 1 is written into 
the table, or if an item is blank, then DX10 only requires one of the item. The ITEM SIZE column is 
available for you to write in the result of your SIZE times QTY calculation. On some of the items, a 
blank space is included in the SIZE column for you to write in a subtotal. Constants appear in the 
column in which the other numbers you write in should be added. The SUM OF ITEMS column con- 
tains values obtained by computing sums and differences of other items. Constants used in com- 
puting such sums and differences appear in that column. Paragraph I.3 provides an explanation of 
items listed in the memory estimator. 
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ITEM DESCRIPTION 
NO. 



SIZE 



QTY 



ITEM 
SIZE 



SUM OF 
ITEMS 



REQUIRED 
(YES/NO) 



** ALL NUMBERS ARE IN DECIMAL BYTES ** 



MAP SEGMENT 1 

REQUIRED PARTS AND DEVICE SUPPORT 

1. OPERATING SYSTEM 

2. POWERFAIL SUPPORT 

3. DISK(S) 

4. DISK CONTROLLER (S) 

5. 911/913 VDT(S) 

6. 931/940 VDT(S) 

7. 931/940 LINE PRINTER 

8. LINE PRINTER (CI403 

OR CI404) 

9. LINE PRINTER (SERIAL) 

10. LINE PRINTER (PARALLEL) 

11. 733 ASR W/CASS(S) 

12. 733 KSR(S) 

13. 820 KSR 

14. TELEPRINTER DEVICE 

15. MAG TAPE (979 OR 

CARTRIDGE) 

16. MAG TAPE CONTROLLER (S) 

17. DISKETTE (S) FD800 

18. DISKETTE CONTROLLER (S) 

19. CARD READER (S) 

20. IBM 3270 STATION 

21. 3270 LINE PRINTER 

22. IBM 3780 COMM CHANNEL 

23. IBM 2780 COMM CHANNEL 

24. FILE MANAGERS 

25. SYSTEM OVLY AREA(S) 

26. SUM OF ITEMS 1 THRU 25 

SYSTEM TABLE AREA 

27. 911/913 VDT BUFFERS 

(QTY FROM ITEM 5) 

28. 931/940 VDT BUFFERS 

(QTY FROM ITEM 6) 

29. LP BUFFERS (QTY FROM 

ITEMS 7+8+9+10) 

30. 73 3 ASR BUFFERS 

(QTY FROM ITEM 11) 



12276 
520 


X 

X 
X 
X 
X 


12276 


YES 
NO 


186 


a 


YES 


32 


3 


YES 


160 


= 


NO 


174 


= 


NO 


86 


= 


NO 


150 


X 
X 
X 
X 
X 
X 
X 

X 
X 
X 


a 


NO 


100 


a 


NO 


238 


= 


NO 


324 


a 


NO 


156 


a 


NO 


160 


a 


NO 


178 


a 


NO 


174 


a 


NO 


32 


a 


NO 


108 


a 


NO 


34 


X 


3 


NO 


100 


X 
X 
X 
X 


3 


NO 


160 


a 


NO 


170 


= 


NO 


160 


3 


NO 


160 


X 
X 
X 


= 


NO 


366 


3 


YES 


806 


a 


YES 









86 x 

86 x 

512 x 

258 x 



NO 
NO 
NO 
NO 
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31. 733 KSR BUFFERS 

(QTY FROM ITEM 12) 

32. 820- BUFFERS 

(QTY FROM ITEM 13) 

33. TELEPRINTER BUFFERS 

(QTY FROM ITEM 14) 

34. DISKETTE BUFFERS 

(QTY FROM ITEM 17) 

35. CARD READER BUFFERS 

(QTY FROM ITEM 19) 

36. SUM OF ITEMS 27 THRU 35 

37. ADD. I/O BUFFERS 

38. SYSTEM TABLE 

CONSTANT 

39. ACTIVE FOREGROUND 

TASKS 

40. ACTIVE BACKGROUND 

TASKS 



86 


X 
X 






NO 


160 




NO 


512 


X 


-, 




NO 


256 


X 


s 




NO 


160 


X 

X 


a 




NO 












NO 


2200 
600 


2200 


YES 

YES 


1000 


X 


= 




NO 



41. SYSTEM TABLE SIZE 

(SUM OF ITEMS 38, 
39 , AND 40) 

42. TOTAL SYSTEM TABLE 

SIZE (SUM OF ITEMS 
36, 37, AND 41) 

43. SYSTEM ROOT LIMIT 

44. ROOT SIZE (SUM OF 

ITEMS 26 AND 42) 

45. DIFFERENCE OF ITEM 

43 MINUS ITEM 44 

MAP SEGMENT 2 

46. DEVICE I/O SUPPORT 

47. COMM I/O SUPPORT TABLES 

48. IBM 3270 STATION 

49. IBM 2780/3780 COMM 

SUPPORT TABLES 

50. I/O COMMON SUPPORT 

(SUM OF ITEMS 46 THRU 49) 



32 

1160 

75 

600 



49152 



32 



YES 

NO 

NO 

NO 
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MAP SEGMENT 3 



51. 
52. 

53. 


SVC SUPPORT 

ONLINE DIAG SUPPORT 

SVC 1 SUPPORT 

(SUM OF ITEMS 51 AND 52) 

SVC 2 SUPPORT 
DX10 2.2 SUPPORT 
USER SVCS 
LARGEST OF ITEMS 
53, 54, 55, AND 56 

DISK 

ONLINE DIAG SUPPORT 
AUTO MEDIA CHANGE 
DISK SUPPORT (SUM OF 
ITEMS 58, 59, AND 60) 

911 VDT 

913 VDT 

LINE PRINTER ON EIA/TTY 

733 ASR W/CASS 

733 KSR (NO ASR) 

MAG TAPE (979 OR 

CARTRIDGE) 
ONLINE DIAG SUPPORT 
MAG TAPE SUPPORT 

(SUM OF ITEMS 67 AND 68) 
LP ON 403/404 
940/931 ON CI401 
940/931 ON 9902 
940/931 ON CI403/4 
DISKETTE 
CARD READER 
820 TERMINAL 
TELEPRINTER DEVICE 
IBM 3270 COMM LINK 
IBM 3780 COMM LINK 
IBM 2780 COMM LINK 
911 VDT POWERFAIL 
LARGEST DSR (OF ITEMS 

61 THRU 66, 69 THRU 81) 
LARGEST SEGMENT 3 

(OF ITEMS 57 AND 82) 


7688 
192 


X 

X 
X 

X l 
X I 
X 1 

X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X ] 




YES 
NO 

YES 


54. 
55. 


2804 
200 

2976 
288 
416 


2340 


YES 
NO 


56. 




NO 


57. 


L = 




58. 
59. 
60. 
61. 


YES 

NO 

NO 

YES 


62. 


3936 
2112 
1088 
2864 
1808 

1376 
96 

43"78 

11092 

11146 

11114 

1174 

952 

1986 

5696 

9000 

9000 

9000 

3936 


a 


MO 


63. 


L ■ 


NO 


64. 


a 


NO 


65. 


L ■ 


NO 


66. 


a 


NO 


67. 

68. 
69. 


a 


NO 
NO 

NO 


70. 


a 


NO 


71. 


a 


NO 


/2. 


a 


NO 


73. 


a 


NO 


74. 


a 


NO 


75. 


a 


NO 


76. 


a 


NO 


//. 


a 


NO 


78. 


a 


NO 


79. 


a 


NO 


80. 


a 


NO 


81. 


a 


NO 


82. 






83. 





84. 911 POWERFAIL 

SCREEN BUFFERS 
(QTY FROM ITEM 5) 

85. TOTAL SEGMENT 3 NEEDS 

(SUM OF ITEMS 53 THRU 

56, 61 THRU 66, 

69 THRU 81, AND 84) 



2080 
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FILE MANAGEMENT (COMBINED WITH MAP SEGMENT 1) 



86. FILE MANAGEMENT 4160 

87. KEY INDEXED FILES 5354 

88. FILE MANAGER SUPPORT 

(SUM OF ITEMS 86 AND 87) 

89. LARGEST PHYSICAL 

RECORD ON DISK 

90. SIZE OF COMMON 

91. MEM RES SYS TASKS 4412 

92. TOTAL ADDRESS SPACE 

FOR FILE MANAGER 65440 

93. SUM OF ITEMS 44 

AND 88 

94. DIFFERENCE OF ITEM 

92 MINUS ITEM 93 

95. DX10 LIMIT 63488 

96. SIZE OF LONGEST OVERLAY PATH 

(SUM OF ITEMS 44 , 50, AND 
83) IF ITEM 83 IS 931 DSR, 
USE 46 INSTEAD OF 50. 

97. DIFFERENCE OF ITEM 

95 MINUS ITEM 96 

98. SMALLER OF ITEMS 

4 5 AND 94 

99. LP PDT EXTENSION 

(CI403 OR CI404; 

QTY FROM ITEM 8) 192 

100. 931/940 SCREEN BUFFERS 

(QTY FROM ITEM 6) 2112 



4160 



YES 
NO 



YES 

NO 

4672 YES 



65440 



63488 



101. 



TOTAL SIZE OF MEMORY-RESIDENT 
TASKS AND PROCEDURES ON 
S$PROGA (YOU MUST INCLUDE 
ALL, INCLUDING THOSE MEMORY- 
RESIDENT AT THE FACTORY.) 



102. INTERTASK BUFFERS 

103. GENERATED DISK(S) 480 

104. INTERRUPT HANDLER FOR 

940/931 ON CI401 3302 

105. INTERRUPT HANDLER FOR 

940/931 ON CI402 3356 

106. INTERRUPT HANDLER FOR 

940/931 ON CI403 3324 

107. SUM OF ITEMS 44, 50, 85, 

88, 89, 90, 91, 99, 
100, 101, 102, 103, 
104, 105, AND 106 



NO 

YES 

NO 

NO 

NO 
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1.3 EXPLANATION OF ITEMS OF THE MEMORY ESTIMATOR 

This paragraph provides an additional explanation of the line items on the DX10 Memory 
Estimator. 

ITEM 1. OPERATING SYSTEM 

This is the base portion of the operating system. It contains the anchors for the data structures 

and the common routines that are necessary for the operating system to run. 

ITEM 2. POWERFAIL SUPPORT 

If powerfail is selected, this number represents the routines necessary to provide that function. 

ITEM 3 THROUGH ITEM 23. PHYSICAL DEVICE SUPPORT 

These line items cover the memory requirements for the anchors of the actual physical devices 
that are included in the system. The QTY value should be the number of devices included during 
system generation. The note, "931/940," means that the number of 931 terminals is added to the 
number of 940 terminals and the result entered in the QTY column. 

ITEM 24. FILE MANAGERS 

The file management task processes all the file I/O requests. By including additional copies of this 

task, several file I/O requests may be processed concurrently, yielding faster overall processing of 

requests. A suggested value for this item is 2 tasks. The quantity entered for this item is the 

response to the system generation prompt FILE MANAGEMENT TASKS:(2). At least one must be 

provided. 

ITEM 25. SYSTEM OVERLAY AREA(S) 

DXTO uses overlays. The number of overlay areas affects the response time for non-memory resi- 
dent functions of DX10. The smaller number of overlay areas requires more disk accesses to per- 
form an operation that uses the system overlay area. A suggested minimal value for this item is 2 
overlay areas. The quantity entered for this item is the answer to the system generation question 
OVERLAYS:(2). At least one must be provided. 

ITEM 26. SUM OF THE BASE OPERATING SYSTEM SUPPORT 

This item represents the base operating system tables for devices and necessary system sub- 
routines. Factors not included in this number are the table space for task support, additional 
I/O buffers, and intertask buffer area. 

ITEM 27 THROUGH ITEM 35. CRU DEVICE BUFFERS 

These items represent the estimated amount of table area needed to process I/O requests for 
devices interfaced through the CRU. The QTY should be the number of devices of the specified 
type(s) included in the system. 

ITEM 36. SUM OF CRU DEVICE BUFFERS 

This number represents the total estimated needs for device buffers. System generation will auto- 
matically include this amount in the total system table area. 
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ITEM 37. ADDITIONAL I/O BUFFERS 

The buffers for I/O operations through physical devices are part of the system table area and sup- 
port CRU device I/O, not disk or tape I/O of any sort. (Note that FD800 diskettes and ASR cassette 
tapes are CRU devices.) A value is needed here if communications or special devices are used, or 
if an application will be run that calls Initiate I/O frequently. This number is the correct response to 
the system generation prompt "I/O BUFFERS? (0)." Note that GEN990, the System Generation util- 
ity, wants this value expressed in bytes, as it is in this item. 

ITEM 38. SYSTEM TABLE CONSTANT 

A certain amount of system table space is required just to perform an initial program load (I PL) on 
the system. It is difficult to accurately define a simple equatior^ for determining the dynamic table 
area required. The equation X = 2200 + N * 600 + B * 1000 has been empirically defined using 
multiple terminals doing simple text edits and assembly language assemblies. ITEM 39 supplies 
the constant of the equation while ITEM 40 determines the N v 600 term and ITEM 40 determines 
the B * 1000 term. 

ITEM 39. ACTIVE FOREGROUND TASKS | 

This item is the crux of the table area calculation. An active foreground task in the DX10 operating 
system is a process which requires operator interaction and does not allow other tasks to have 
operator interaction at the same time. This item is an estimate; of the amount of system table area 
required to support an active foreground task. The true requirements depend on the specific appli- 
cation environment. Any given application could require more or less, depending on the number of 
tasks, open files, assigned LUNOs, and locked records that jit uses. For full support of all ter- 
minals, the quantity specified for this item should be equal to the sum of the quantity of items 5, 6, 
11, 12, 13, and 14, which is the number of terminals. A number less than this sum may be used, and 
DX10 will enforce this specified amount. In systems where l^ss than 100% of the terminals are 
active at any given time, specifying a number less than the total number of terminals on the sys- 
tem may be satisfactory. If the maximum number of terminals (s active and a user attempts to acti- 
vate another terminal, the DX10 operating system will reject the request with a message informing 
the user that he cannot be supported at this time. The quantity entered for this item is the answer 
to the system generation question SCI FOREGROUND? (8). 

ITEM 40. ACTIVE BACKGROUND TASKS 

An active background task in the DX10 operating system is aiprocess associated with a terminal 
that is not a foreground process (that is, a process executed via an SCI .QBID primitive). This item 
is an estimate of the amount of system table area required tojsupport an active background task. 
As with the estimate for the foreground task described in ITEM 39, the true requirement depends 
on specific details of the background process. The quantity entered for this item is the answer to 
the system generation question SCI BACKGROUND? (2). Yoii should carefully evaluate whether 
you need more than the default value. Most systems run satisfactorily with 2 backgrounds, and 
more than that will allow backgrounds to use more table area* leaving less to support foreground 
activities. 

ITEM 41 . SYSTEM TABLE SIZE (SUM OF ITEMS 38, 39, AND 40) 

This is the dynamic table area out of which the operating system allocates work areas to service 
requests from active tasks in the system. This item is a composite of estimates, so the result given 
by the estimator may vary from the actual use by the running system. To provide a better number 
for system generation, it is necessary to monitor usage of the; system table area on a running sys- 
tem. This can be done by using the Show Memory Status (SMS) command. This number is the 
answer to the system generation prompt TABLE?. The number in this item is expressed in bytes, 
so you must convert to words (by dividing by two) to specify it during system generation. 
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ITEM 42. TOTAL SYSTEM TABLE AREA (SUM OF ITEMS 36, 37, AND 41) 
This item is the total space allocated for the system table area. 

ITEM 43. SYSTEM ROOT LI M IT 

The system tasks of DX10 are loaded at address 49152 (>C000). If the root portion of DX10 is larger 

than 49152, some overlapping of address space occurs with unpredictable results. To prohibit 

error conditions, the root of the DX10 operating system is limited to less than 49152 bytes in total 

length. 

ITEM 44. ROOT SIZE (SUM OF ITEMS 26 AND 42) 

The base operating system table support and the system table area comprise the system root. 

ITEM 45. DIFFERENCE OF ITEM 43 MINUS ITEM 44 

Subtract item 44 from item 43. The result, if positive, represents the amount by which the system 
root is less than the 49152-byte limit. If this number is negative, the system will exceed the allowed 
root size and either the system table area or the base operating system support tables must be 
decreased. The system generation process (PGS) will not allow the system root to exceed the 
49152-byte upper limit. 

ITEM 46. DEVICE I/O SUPPORT 

DX10 provides common routines that support device I/O. This number includes the size of the 

routines necessary to support physical devices, the clock, and error interrupts. 

ITEM 47. COMMUNICATIONS I/O SUPPORT TABLES 

The IBM 3270 and/or 2780/3780 Communications Emulator package under DX10 requires that a 
module COMMCOM be included in the DEVICE I/O SUPPORT phase of the system structure. 
Details concerning the COMMCOM are documented in the communications package manuals. 
COMMCOM contains data structures and code to interface between the communications physical 
device I/O support and the standard DX10 I/O modules. 

As a word of caution, generating a DX10 operating system with the 3270, 3780 and 2780 communi- 
cations packages or combinations of a pair of the packages does not result in a memory size 
requirement equal to the sum of the memory required for individual packages. Some modules are 
shared and some modules reside in different portions of DX10 when two or more packages exist. 

ITEM 48. IBM 3270 STATION 

For each IBM 3270 emulated station (either a printer or VDT), table area is required. 

ITEM 49. IBM 2780/3780 COMMUNICATIONS SUPPORT TABLES 

Table areas are required for each IBM 2780/3780 communications link supported by the DX10 oper- 
ating system. 

ITEM 50. I/O COMMON SUPPORT (SUM OF ITEMS 46 THROUGH 49) 

Routines common to all I/O requests for all files and devices are represented in this number and 

are referred to as I/O COMMON. 

ITEM 51. SUPERVISOR CALL (SVC) SUPPORT 

DX10 provides routines that are used to support SVCs. This number includes the size of the 

routines that support the standard SVCs used by DX10 software. 
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ITEM 52. ONLINE DIAGNOSTICS SUPPORT 

If Online Diagnostics Support is requested, routines needed by DX10 and its DSRs are represented 

in this number. If Online Diagnostics Support is requested, you must include items 59 and 68. 

ITEM 53. SVC 1 SUPPORT (SUM OF ITEMS 51 AND 52) 

The total size of one of the SVC support segments required by DX10 is computed in this item. 

ITEM 54. SVC 2 SUPPORT 

DX10 routines necessary to support SVCs not supported in item 53 are represented by this 
number. 

ITEM 55. DX10 2.2 SUPPORT 

Routines necessary to support the character mode SVCs are represented in this number. Include 

them if you selected these SVCs in your system. 

ITEM 56. USER SVCS 

The total size of ail modules included for user-written SVCs must be represented in this number. If 

there are none, enter zero. 

ITEM 57. LARGEST OF ITEMS 53, 54, 55, AND 56 

This item selects the largest of the modules used for SVC support. It is used in calculating the 

longest overlay path of the system. 

ITEMS 58 THROUGH 81. PHYSICAL DEVICE SERVICE ROUTINES (DSRS) 
These values are the sizes for the standard DX10 supported devices. Only one copy of the neces- 
sary DSR will be included in the system even when more than one physical device of the same type 
is connected to the system. The DISK term includes the DSDD of the FD1000 and the WD500 
drives, while the DISKETTE term is used only for the FD800 drive. 

The communications physical device support for DX10 contains modules to control a communi- 
cations link using the IBM binary synchronous communications line discipline. They interface 
with standard DX10 I/O support via specialized modules included in the DEVICE I/O SUPPORT por- 
tion of DX10. One DSR module will support multiple communications links of the same type. Refer 
to the communications package manuals for further details. 

The 733 terminal uses the same keyboard and printer handler routine whether cassettes are pre- 
sent or not. Therefore only one of ITEM 65 or ITEM 66 should be included in a system estimate. 

The 911 support either includes the powerfail option or does not. The powerfail option cannot be 
chosen for some 911 terminals in the system and rejected for others. If powerfail is selected, see 
item 81 for more information. 

ITEM 81 . 911 VDT POWERFAI L 

If powerfail is selected and there are any 911 terminals included in the system, include this item in 

the sum of line 85. You must also omit item 62 and include item 84. 
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ITEM 82. LARGEST DSR (OF ITEMS 61 THROUGH 66 AND 69 THROUGH 81) 

The manner in which DX10 is constructed allows each DSR to be in the last segment of the map 

file describing the overlay of DX10 containing the DSR. The length of DX10 actually describes the 

longest overlay of DX10. The longest DSR will determine the longest overlay. If special devices (SD 

to system generation) are to be included, check the length of your longest special device DSR 

against the value obtained for this item, and substitute it if it is longer than any of the standard 

DXIODSRs. 

ITEM 83. LARGEST SEGMENT 3 (OF ITEMS 57 AND 82) 

This number is used to compute the longest overall address path that must be used by DX10. 

ITEM 84. 911 POWERFAIL SCREEN BUFFERS 

If powerfail recovery is selected, 911 terminals require a screen buffer. The number of 911 ter- 
minals included during system generation (quantity of item 5) is entered in the QTY column to 
compute the total amount of buffer space needed. 

ITEM 85. TOTAL SEGMENT 3 NEEDS 

This total is the amount of memory needed to hold the DSRs, SVC support, and any screen buffers 

needed. This number is not part of the longest overlay path. 

ITEM 86. FILE MANAGEMENT SUPPORT 

DX10 supports different file types: relative record, sequential, program, and image. This item is the 

size required to support the standard files DX10 uses. 

ITEM 87. KEY INDEXED FILES (KIFS) 

DX10 optionally supports key indexed files (KIFs). If you select KIF support, include this item and 
respond YES to the system generation prompt KIF? (NO) to include KIF logic in the newly gener- 
ated system. 

ITEM 88. FILE MANAGER SUPPORT (SUM OF ITEMS 86 AND 87) 

This total is the amount of memory required to hold the total file management support. 

ITEM 89. LARGEST PHYSICAL RECORD ON DISK 

DX10 requires a memory-resident buffer as a backup buffer for handling blocked files. This item 
reflects the largest physical record size of all blocked files that will be used in your system. This 
number is entered for the system generation parameter BUFFER MANAGEMENT: (1K) and should 
only be the size of the largest blocked physical record. 

ITEM 90. SIZE OF COMMON 

The task common area is a region of system memory accessible by all tasks. It is used for com- 
munication and coordination between tasks and its size is directly dependent on the needs of the 
application tasks using this area. This is an optional item. Determine the length by inspecting 
the assembly listing for the object module you have included for the prompt during system 
generation. 

ITEM 91. MEMORY-RESIDENT SYSTEM TASKS 

DX10 requires some tasks to be in memory at ail times. These tasks perform specific functions 
necessary to the operation of the operating system. This item reflects the size of these tasks, 
which are linked into the memory-resident portion of the system. 
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ITEM 92. TOTAL ADDRESS SPACE FOR FILE MANAGER 

This number represents the practical limit on address space usage by the file manager task. 

ITEM 93. SUM OF ITEMS 44 AND 88 

This item represents the total address space occupied by the system root and the routines neces- 
sary to support file management functions. 

ITEM 94. DIFFERENCE OF ITEM 92 MINUS ITEM 93 

Subtract item 93 from item 92. The result represents the total amount of address space available to 
the file manager for handling blocking of user records in and out of physical records. It can be div- 
ided into two parts, one for the logical record and one for the physical record, in any ratio needed 
by the application. However, large physical records (over half the space available) can create prob- 
lems with utilities such as CKS, BD, and RD. Therefore, it is wise to plan your physical records to 
be, at most, half this number. Also consider that future system generations may reduce this 
number. See Volume III of this set for more information on physical records, and Section 4 of this 
manual for more information on how the file manager handles available address space. 

ITEM 95. DX10 LIMIT 

DX10 is bounded by hardware limitations. The number given here is the maximum address usable 

by a DSR or SVC segment. 

ITEM 96. SIZE OF LONGEST OVERLAY PATH (SUM OF ITEMS 44, 50, AND 83) 
With the structure of DX10, the maximum size that DX10 can become depends on the length of the 
longest overlay path and not on the total sum of ail the parts. Therefore, the DX10 operating sys- 
tem can occupy more than the address space limit of 63,488 bytes. This item defines the combined 
length of the first, second, and the longest of the third segments of DX10 that gives the longest 
overlay path. (The longest overlay path cannot exceed 63,488 bytes.) 

ITEM 97. DIFFERENCE OF ITEM 95 MINUS ITEM 96 

Subtract item 96 from item 95. The result, if positive, is the amount of memory by which the long- 
est overlay path could be larger. If negative, the system must be made smaller by reducing items 3 
through 40 and items 46 through 50, or identify and remove the item that defined item 83 so that it 
becomes smaller. 

ITEM 98. SMALLER OF ITEMS 45 AND 94 

The system table area can be made larger by the smaller of these two numbers. If either of the 
numbers included here is negative, the system will have to be made smaller. Bear in mind that 
these are estimates, and that if it is within several hundred bytes of zero only a trial system genera- 
tion will inform you whether the system can be made to work. The PGS command produces an 
error message if the system is too large. 

ITEM 99. LP PDT EXTENSION (CI403 OR CI404) 

Any serial line printer interfaced through a CI403 or CI404 TILINE multiplexing controller will have 
a PDT extension that is not included in any of the mapped parts of the operating system. This item 
includes them in the total size of the memory-resident portion of the operating system, 

ITEM 100. 931/940 SCREEN BUFFERS 

The screen buffers for handling 931 and 940 terminals do not appear in any of the mapped portions 
of the system. Incorporate here the number of 931 and 940 terminals included in the system gen- 
eration. The buffers are included in the total memory-resident portion of the operating system. 
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ITEM 101. TOTAL SIZE OF MEMORY-RESIDENT ROUTINES 

This item includes the size of all tasks and procedures marked memory-resident in the system 
program file. A standard DX10 has one memory-resident task and two memory-resident pro- 
cedures. These and any additional procedures and tasks that you make memory resident become 
part of the static memory size displayed by the Show Memory Map (SMM) command and should be 
added before comparing actual total memory with predicted total memory. To compute the 
amount of memory needed by a memory-resident segment, determine its length from a Map Pro- 
gram File (MPF) command on the system program file, add >3F, and then round down to the next 
lower integer value that is evenly divisible by >20. For example, a task listed as >3A8 bytes in 
length will occupy >3E0 bytes of memory when loaded, as shown by the following formula: 

((>3A8 + >3F)/>20)* >20 = >3E0 

ITEM 102. INTERTASK BUFFERS 

The intertask communication buffers, different than COMMON, are not taken from the system 
table area. This number is the maximum bytes of memory that the DX10 operating system can use 
for intertask communications buffers. If you are using TIFORM or Sort/Merge, refer to the appro- 
priate manual. This number is the response to the system generation prompt INTERTASK? (100). 
Note that the value included here must be in bytes and that for GEN990 it must be expressed in 
words. 

ITEM 103. GENERATED DISK(S) 

The information necessary to access a disk when it is installed is maintained in the system table 
area and in a separate disk information area. System table area needs are included in the estimates 
for items 39 and 40. This item includes the space needed for bit maps which are not stored in the 
system table area. Memory is set aside by the system loader for each disk (except FD800) included 
in the system generation. The quantity entered here is the total number of disks generated. 

ITEM 104 THROUGH 106. INTERRUPT HANDLING 

This is the interrupt handling portion of the respective terminal support routine. It is required when 

that device is defined to the system during system generation. 

ITEM 107. SUM OF ITEMS 44, 50, 85, 88, 89, 90, 91, 99, 100, 101, 102, AND 103. 
This is the total memory-resident size of the system. Subtract this number from the total available 
memory on the computer. The result is the amount of memory available for user tasks or for SCI. If 
the result is small enough to cause excessive rollin/rollout when running the application pro- 
grams, response time will be adversely affected. Do not include tasks that will be rolled out most 
of the time the application will be running, such as SCI. If response is slow because of rollin/ 
rollout, more memory will help. 

Response time is also affected by the compute load imposed by the application program. The only 
helps for this condition are to reduce the compute load and/or get a faster processor. 

The estimator can be expected to yield an estimate of system size that is accurate within 300 bytes 
most of the time. In the above items, reference is made to limits not being exceeded. In practice, 
you will find that if the estimator shows that the system is too large, the system may still be suc- 
cessfully generated. However, this is an important clue that the system's limits are being reached; 
special attention in application design may be required to meet the projected table area use. Con- 
versely, the estimator may show that a configuration can be successfully generated when, in fact, 
it cannot. The following paragraphs give some indications on how to handle the estimation better. 
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I.4 HINTS ON DETERMINING TERMINAL CAPACITY 

Many factors affect the terminal capacity of DX10, but the greatest one is system table area. The 
number of devices in the configuration is the primary adverse effect on the maximum table area 
that can be specified. Also of importance is the number of communications lines, RTS devices, 
and RTC devices generated. These devices require space larger than the size of ITEMS 3 through 
19 and ITEMS 27 through 35. Since applications and SCI that are needed to run a terminal use table 
space, it follows that the more devices there are, the more economical the use of table area per 
terminal must be. The sizes in ITEMS 39 and 40 are based on economical use; the values in Table I 
3-8 of Volume V are based on heavier development use where the user of the system is doing a typ- 
ical interactive application requiring a number of files to be open, which takes more table area. 
These two numbers have the greatest unpredictable effect on the estimation of system size and 
capacity. The guide is designed so you can compute all other terms and then experiment with var- 
ious values for these two items as noted in the following paragraph. 

Two things can be done with the guide. You can determine if an application program with known 
table requirements will run on a given configuration, or you can determine the amount of table area 
available per terminal. The latter information is a guide for a design-to-fit exercise in which you 
determine the available table area per terminal and check whether it is possible to design an appli- 
cation to operate within that limit. Note that whatever basis is used, the root size in ITEM 44 can- I 
not exceed the value in ITEM 43. 1 

Determining table area requirements for one terminal for an application is not a simple matter. The 
best way is to benchmark it on an existing DX10 system. It may not be necessary to write the entire 
application to do this; dummy programs that open the required number of files and do a similar 
amount and kind of I/O can be written. The table area use for at least two, preferably more, can be 
observed using the SMS command after each invocation of the task. Any data base files that need | 
to be set up can be set up with dummy fields and records. The tasks do not have to actually call the 
data base, but the data base needs to be started and the number of files needed must be opened. 
The basic idea is to determine the base table area need that is required to start one terminal, then 
determine the incremental need (that is, the space required to bring up each additional terminal). 
Then, based on the information in the estimator, the terminal capacity for that configuration is 
obtained as follows: 

1. Determine the maximum table area for your system. This can be done in one of several 
ways: 

a. Add item 98 to item 41 and recompute the rest of the estimator; | 

b. Perform a trial system generation (including PGS) and maximize the table area 
according to instructions in Section 3. Then, either look in DSSOURCE for the value 
giving the size of table area (identified by comments in that file) or boot the system 
and perform an SMS. Then, substitute the value obtained from SMS into item 42. 

2. Subtract the value of ITEM 26 from the value of ITEM 42. 

3. Subtract the base table area for the application from the result of step 2. (Remember that 
the SMS command presents values in words.) 

4. Divide the incremental table area requirement for the application into the result of step 
3. The result plus one is approximately the number of terminals that can be supported. 
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Exercise care not to overestimate terminal capacity. System table area fragmentation occurs 
because all pieces allocated out of it on a dynamic basis are not the same size, and the order of 
allocation is random. This has the effect of increasing the amount of table area needed for an 
application. Other things are also allocated out of table area, including record-lock table entries 
that may not show up in a dummy application. You can largely compensate for those effects by 
increasing the estimate of the incremental table area requirement by 15 percent. If the calculation 
shows over 15 terminals can be supported, be wary. Extra tuning may be necessary to actually 
achieve the calculated result. (In some environments, nine terminals may be the number that can 
be supported.) Such things as background execution consume table area and can cause the limit 
(in practice) to be lower than calculated. Be persistent in your search for all possible things that 
use table area and include them in your calculation. Use the Show System Table Map (SSTM) 
command on your running system to show what is taking up table area. You can determine 
whether reducing either the number of tasks, the number of LUNOs assigned, or the number of 
files assigned will affect the execution of your system with your application. 

The available table area per terminal can be determined by the following steps: 

1. Perform the computation outlined in items 1 and 2 in the preceding list. 

2. Divide the result of step 1 by the number of terminals you desire to support. The result is 
the average table area that can be occupied by each terminal's needs and not exceed the 
maximum table area that can be specified. 

Note that the average includes the extra amount needed for starting the application spread out 
over all the terminals. You can use this number when designing the application as a guide to the 
number of tasks that can be associated with each terminal and the number of files that can be 
open. 
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Exa m p le Patch File 



Appendix J contains a listing of an example patch file created by the Assemble and Link 
Generated System (ALGS) command and applied to the system by the Patch Generated System 
(PGS) command. Refer to Section 3 for information on the ALGS and PGS commands. 
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************************************************************************ 

BATCH LS=YES 
******************************************************************************* 

*** PATCH FILE MEMRES DXlO 3.6.0 LAST UPDATE 04/22/83 *** 
******************************************************************************* 

* 

* *** SPECIAL INSTRUCTIONS *** 
* 

* AFTER A SYSGEN IS DONE, THE DXlO IMAGE FILE (OBJECT OUTPUT FROM 

* THE LINK EDITOR) WILL NEED TO HAVE THE PATCHES IN THIS FILE 

* APPLIED TO IT. THIS FILE CANNOT BE RUN AS A BATCH STREAM. TO 

* PATCH A SYSTEM, ONE MUST ASSIGN THE SYNONYM $$DSC$ TO THE 

* VOLUME NAME OF THE DISK ON WHICH THE PATCHES ARE TO BE APPLIED. 

* THEN EITHER (A) OR (B) BELOW MUST BE PERFORMED. 
* 

* A) RUN THE XPS PROC , WITH THE FOLLOWING INPUTS: 

* LINK = <THE LINK MAP OF THE SYSTEM TO BE PATCHED> 

* INPUT = <THE NAME OF THIS FILE> 

* OUTPUT » <THE NAME OF A FILE, WHICH IS TO BE USED AS THE 

* BATCH STREAM> 

* ERROR * <THE NAME OF SOME FILE TO BE USED FOR ERRORS > 

* THE FILE SPECIFIED FOR OUTPUT CAN BE RUN AS A BATCH STREAM 

* TO PATCH THE SYSTEM. 
* 

* B) IF THE LINK MAP IS NO LONGER AVAILABLE ON DISK FILE, THIS FILE 

* WILL HAVE TO BE TRANSLATED MANUALLY. COPY THIS FILE TO 

* ANOTHER FILE AND EDIT THAT FILE DOING THE FOLLOWING. 

* 

* 1. FOR EACH #SYN COMMAND FOUND IN THE FILE, TWO OR MORE 

* SYNONYMS MUST BE DEFINED. EACH #SYN COMMAND IS IN THE 

* FORMAT : 

* #SYN <OVERLAY OR TASK ID> , <MODULE NAME> , <MODULE NAME> , ... 

* FOR EXAMPLE: 

* #SYN SROOT,ROOT 

* WHERE: 

* SROOT IS THE <OVERLAY OR TASK ID> SYNONYM NAME, AND 

* ROOT IS THE <MODULE NAME> OF THE MODULE TO BE PATCHED. 

* 

* 2. FIND THE <MODULE NAME>S IN THE LINK MAP. ALL MODULES 

* ON ONE LINE OF A #SYN COMMAND WILL RESIDE IN THE SAME PHASE 

* OF THE LINK. DETERMINE THE OVERLAY OR TASK ID FROM THE 

* PHASE HEADER LINE OF THE PHASE WHERE THE SPECIFIED MODULES 

* ARE FOUND. INSERT A #SYN COMMAND INTO THE PATCH FILE TO 

* DEFINE THE OVERLAY OR ID, AS IN THE FOLLOWING EXAMPLE: 

* .SYN SROOT=l 

* WHERE 

* SROOT IS THE <OVERLAY OR TASK ID> SYNONYM FOUND 

* IN THE #SYN COMMAND, AND 

* 1 IS THE OVERLAY OR TASK ID FROM THE PHASE 

* IN WHICH THE LISTED MODULES RESIDE. 

* (1 IS THE ID FOR THE FIRST SYSTEM. THIS WILL 

* BE DIFFERENT FOR ADDITIONAL SYSTEMS.) 
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* 3. NEXT, INSERT .SYN COMMANDS INTO THE PATCH PILE FOR EACH 

* <MODULE NAME> IN THE #SYN COMMAND. FOR EXAMPLE: 

* .SYN ROOT=0 31DA 

* WHERE: 

* ROOT IS THE <MODULE NAME> OF THE MODULE (FROM THE #SYN 

* COMMAND) TO BE PATCHED, AND 

* 03 IDA IS THE HEXADECIMAL ADDRESS OF THE MODULE 

* ORIGIN FOR TI-SUPPLIED SYSTEM. (THIS MAY BE 

* DIFFERENT FOR CUSTOM SYSTEMS.) 
* 

* 4. DELETE THE #SYN LINE FROM THE PATCH FILE. 

* 

* 5. REPEAT STEPS 1-4 FOR EACH #SYN COMMAND IN THE FILE. 
* 

* 6. DELETE ALL THE %SYN LINES FROM THE PATCH FILE. 
* 

* 7. QUIT THE TEXT EDIT SPECIFYING "YES" TO THE REPLACE OPTION. 

* 8. EXECUTE THE BATCH STREAM YOU JUST CREATED. 

************************************************************************ 

*** SYNONYM ASSIGNMENT 

* 

Q$SYN 

.SYN $E$C«"0" 

.SYN IMAGE- "@$$DSC$.S$ IMAGES" 

%SYN SROOT,ROOT 

%SYN SROOT,TM$PFN 

%SYN SFILMG,FILMG,KIF3 l FILMG REQUIRED FOR SYSTEM LENGTH CHECK 

%SYN SMEM,MEMRES 

%SYN SIO,SVCIO,TM$CKY 

%SYN S2D,SVC2ND,SYSLOG 12ND SVC SEGMENT 

%SYN IOCIOCOM 

%SYN SDDIO,DDIOSR,OLDDKY 

%SYN S911,DSR911 

%SYN S913,DSR913 

%SYN SLP,LPDSR 

%SYN S820,DSR820 

%SYN SFPY,FPYDSR 

%SYN S979,DSR979,OLDTPY 

%SYN S733,DSR733 

%SYN STPD,DSRTPD 

%SYN S93C,DSR93C 

%SYN SSPCDSRSPC 

%SYN S93B,DSR93B 

******************************************************************************* 

* THE FOLLOWING SYNONYMS ARE DEFINED BY TI SYSTEM ANALYSTS ONLY AT 

* SYSTEM BUILD TIME. THEY SHOULD NOT BE MODIFIED BY THE USER. 
******************************************************************************* 

* INSERT PRE-LINK DEFINED SYNONYMS HERE: 

#SYN SROOT,ROOT 

.EVAL S$$PAT="@ROOT+>0000" 
* 

************************************************************************** 



946250-9705 J -3 



Example Patch File 



* CHECK TO SEE IF THE SYSTEM ROOT IS GREATER THAN >C000. 

* THIS CAUSES SEVERAL PROBLEMS IN DISK RESIDENT SYSTEM TASKS. 

• 

#SYN SFILMG,FILMG 
•IF @FILMG,GT,>C000 

CM R=ME,M=" PATCH STREAM FATAL ERROR- 
CM R=ME,M»" SYSTEM ROOT EXCEEDS >C000 " 
CM R«ME,M»" CURRENT SYSTEM ROOT SIZE - QFILMG " 
CM R=ME,M-"PATCHING TERMINATED" 
.STOP 
.END IF 
.SYN SFILMG="",FILMG="" 

*************************************************************** 
* 

* CHECK TO SEE IF THE SYSTEM LENGTH IS GREATER THAN >F300. 

* THIS CAUSES SEVERAL PROBLEMS IN EXECUTION AS ANY REFERENCE 

* IN THE OS TO ADDRESSES ABOVE >F800 TALK TO DISKS INSTEAD 

* OF MEMORY. 

* 

.IF @SROOT,EQ,>100 

CM R«ME,M«" PATCH STREAM FATAL ERROR" 

CM R=ME,M«" LONGEST OVERLAY PATH EXCEEDS >F800" 

CM R-ME,M»" PATCHING TERMINATED" 

.STOP 

.ENDIF 

* 

********************************************************************** 

* The following are the current versions of the templates for each 

* type of patch. The colunm positions in the header are important. 

* Note each comment starts in column 4. Each line extends no further 

* than column 70, with the exception of star lines for separators. 

* No more than four verify or data items allowed per MPI/MRF/MAD. 
****************************************************************************** 

* 

*=Pnnnn INT MM/DD/YY STR #mmmmm v.r.e modulename DX10 

* 

* up to ten lines of description of the patch (each line of the form 

* shown here - star, two blanks, then words) 
* 

*Q$SYN 

*#SYN ovlynam,modnam 

*MPI PF= IMAGE, MT=tt,MN=modnam,ADR=>0 000, 

* V=(> ,> ,> ,> ), 

* D-(> ,> ,> ,> ) ,C=> 
*EC 

*.SYN ovlynam= n " ,modnam="" 

*$ 
****************************************************************************** 
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* 

*=Pnnnn INT MM/DD/YY STR #mmmmm v.r.e modulename DX10 

* 

* up to ten lines of description of the patch (each line of the form 

* shown here - star, two blanks, then words) 
* 

*Q$SYN 

*MRF PN=pathname,RN=nnnn,FW=mmmm, 

* V«(>,> , > , > ), 

* D»(> r> r> r> ) rC"> 

*EC 

*$ 
****************************************************************************** 

* 

*=Pnnnn INT MM/DD/YY STR #mmmmm v.r.e modulename DX10 

* 

* up to ten lines of description of the patch (each line of the form 

* shown here - star, two blanks, then words) 
* 

*Q$SYN 

*MTE PF=programf ile ,MN=module ,PRIORITY= 

*EC 

*$ 
****************************************************************************** 

* 

*=Pnnnn INT MM/DD/YY STR #mmmmm v.r.e modulename DX10 

* 

* up to ten lines of description of the patch (each line of the form 

* shown here - star, two blanks, then words) 
* 

*Q$SYN 

*MAD DISK=diskname , TRACK=nnnn , SECTOR*mmmm , FW=wwww , 

* V=(> , > ,> ,> ) t 

* D=(> ,> ,> r> ) fC=> 

*EC 

*$ 
**************************************************************************** 

* end of templates 

**************************************************************************** 
* 

* BEGIN PATCHES FOR RELEASE 3.6.0 
* 

******************************************************************************* 
* 

* INSERT PATCHES HERE. BE SURE TO FOLLOW EACH MP I CALL WITH AN EC CALL. 
* 
******************************************************************************* 
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********************************************************************** ********* 

* 

*=Pnnnn CIW/INT 04/28/83 KI$LOC3 STR #mmmmm 0.6.0 KIF3 DX10 

* fix >A0 crash in fan #4 

* 

#SYN SFILMG,KIF3 

.IF @KIF3, NE, "NONE" 

Q$SYN 

MPI PF=»IMAGE,MT=OV,MN»@SFILMG,ADR-@KIF3+>115C+>0190, 

V»>06A0 ,D->0460 , >C=»0460 

EC 

MPI PF=IMAGE,MT-OV,MN«@SFILMG,ADR»@KIF3+>115C+>0192, 

V=@ROOT+>190C,D=€S$$PAT,C=@S$$PAT 

EC 

MPI PF=* IMAGE, MT=TA,MN=@SROOT,ADR=@S$$PAT, 

V=(>DEAD,>DEAD) , 

D=(>CE8B,>06A0) , 

C=>C82B 

EC 

MPI PF» IMAGE, MT»TA,MN=»@SROOT,ADR=@S$$PAT+>0004 , 

V»>DEAD,D=@ROOT+>190C,C»@ROOT+>190C 

EC 

MPI PF= IMAGE, MT-TA,MN=@SROOT,ADR»@S$$PAT+>0006, 

V»>DEAD,D»>460 ,C=>0460 

EC 

MPI PF=IMAGE,MT=TA,MN»@SROOT,ADR»@S$$PAT+>0008, 

V=>DEAD,D=@KIF3+>115C+>0194,C=@KIF3+>115C+>0194 

EC 

•ENDIF 

.SYN KIF3="" 

*$ 

******************************************************************************* 

* END OF 3.6.0 PATCHES 
Q$SYN 

#SYN SROOT,ROOT 

MPI PF= IMAGE, MT=TA,MN=@SROOT,ADR=@S$$PAT+>0240,V=»2D31,D=>2030,C=>2030 

I EC 

******************************************************************************* 

* 

CM R=ME,M=" SYSTEM PATCH STREAM ERROR COUNT = @$E$C" 
******************************************************************************* 
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Example Patch File 



* 

* *** DELETE SYNONYMS THAT ARE UNIQUE TO THIS BATCH STREAM *** 
* 

Q$SYN 

.SYN IMAGE="", S$$PAT="" 

.SYN SROOT="", ROOT-"", S820»"" , DSR820= ,,M 

.SYN SFILMG=» ,,M , FILMC*"", KIF= M ", KIF3=" " ,HKIF-" " 

.SYN SMEM» ,,H , MEMRES="", SIO="", SVCIO»"" 

.SYN DDIOSR-"", SODI©-"" , OLDDKY-"", IOC-"", IOCOM-"" 

.SYN S911= MH , DSR911-""» SLP» rt ", LPDSR= ,,W 

.SYN S913-"", DSR913-"" 

.SYN SFPY=" n , FPYDSR-"" 

.SYN STPD" 1 " 1 , DSRTPD* 1 '" 

.SYN SKIF3= M " ,S2D= BM f SVC2ND= H " ,SYSLOG= n " 

.SYN DSR979="" / COMMCOM="",DSR733="" 

. SYN SVCUSR=" " , SVCOPT=" " , T940=" " 

.SYN S733= ,,u ,3979="" ,SCOM=*"" ,TM$CKY="" 

.SYN OLDTPY=""/TM$PFN="" 

* 

******************************************************************************* 

SDT 

EBATCH LS^Y 

******************************************************************************* 

* THE NEXT AVAILABLE PATCH LOCATION IS S$$PAT+>000A 
******************************************************************************* 
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Alphabetical Index 
Introduction 



HOW TO USE INDEX 

The index, table of contents, list of illustrations, and list of tables are used in conjunction to ob- 
tain the location of the desired subject. Once the subject or topic has been located in the index, 
use the appropriate paragraph number, figure number, or table number to obtain the corre- 
sponding page number from the table of contents, list of illustrations, or list of tables. 

INDEX ENTRIES 

The following index lists key words and concepts from the subject material of the manual together 
with the area(s) in the manual that supply major coverage of the listed concept. The numbers along 
the right side of the listing reference the following manual areas: 

• Sections — Reference to Sections of the manual appear as "Sections x" with the sym- 
bol x representing any numeric quantity. 

• Appendixes — Reference to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

• Paragraphs — Reference to paragraphs of the manual appear as a series of 
alphanumeric or numeric characters punctuated with decimal points. Only the first 
character of the string may be a letter; all subsequent characters are numbers. The first 
character refers to the section or appendix of the manual in which the paragraph may be 
found. 

• Tables — References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number. 

Tx-yy 

• Figures — References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number. 

Fx-yy 

• Other entries in the Index — References to other entries in the index preceded by the 
word "See" followed by the referenced entry. 
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Index 



Address: 

CRU 3.2.2 

TILINE 3.2.4 

ALGS Command Appendix J, 3.5, 4.5 

Assemble and Link Generated System 
(ALGS) Command Appendix J, 3.5, 4.5 

Assembling and Linking the System, 
System Generation 3.5 

Assign Space on Program File 
SVC>37 7.15 

Asynchronous: 

Data Structure Allocation 5.5.5 

Data Structure Linkages F5-20 

Device Support T5-7 

DSR Local PDT Extension 5.3.6 

DSR Long-Distance Device 

Extension 5.3.7 

DSR Structure 5.5 

Interrupt Service Routine (ISR) 5.5.3 

ISR 5.5.3 

Backup Directory (BD) Command 2.9 

Backup Directory to Device (BDD) 

Command 2.9 

Base System Configuration 2.2 

BATCH Command 4.5 

BD Command 2.9 

BDD Command 2.9 

Begin Batch Execution (BATCH) 

command 4.5 

Boards, Interface T3-9, T3-10 

Branch Table Call (BRCALL) Routine . . 5.7.1 
Branch Table Call with Statistics 

(BRSTAT) Routine 5.7.10 

BRCALL Routine 5.7.1 

BRSTAT Routine 5.7.10 

Buffered I/O Request Block 5.3.3 

Business System Terminal 

Keyboard Layout FA-5 

Busy Check (BZYCHK) Routine 5.7.2 

BZYCHK Routine 5.7.2 

Call Block, SVC 6.2.1 

CD Command 2.9 

CDM F2-2 

Chassis, Expansion 3.4.4.20, 3.4.5.1, F.5 

Clear Secret Synonyms (Q$SYN) 

Command 4.5 

Codes, SVC TG-1 

Command See name or 

acronym of command 

Command Mode, GEN990 3.3.2.2 

Compatibility, DX10 2.X Section 8, 1.7 

SVC 8.3 

Control/Display Module (CDM) F2-2 

Controller Interrupt Decoder 

HSR Subroutine 5.6.9 

Conversion, DX10 2.X: 

Disk 8.2 

Disk/Magnetic Tape 8.2.1 

Log 8.2.2.2 



Multiple Disk 8.2.2 

Copy and Verify Disk (CVD) 

Command 2.9 

Copy Directory (CD) Command 2.9 

Copy Volume (CV) Command 2.5.2, 2.9 

Crash 4.3.1 

CRU Address 3.2.2 

CV Command 2.5.2, 2.9 

CVD Command 2.9 

Data Structures, DSR 5.3 

DCOPY Command 2.9 

Delete Overlay SVC > 2A 7.7 

Delete Procedure SVC > 29 7.6 

Delete Task SVC > 28 7.5 

Device Service Routine 

(DSR) Section 5, Appendix H, 1 .4 

Device, Special 3.4.5.10, F.4 

Direct Disk I/O 7.19 

Disk Build 1.2, 2.5.2 

Disk Build Utility 2.6 

Disk Conversion, DX10 2.X 8.2 

Disk Copy/Restore (DCOPY) 

Command 2.9 

Disk I/O, Direct 7.19 

Disk Manager SVC > 22 7.14 

Disk/Magnetic Tape Conversion, 

DX10 2.X 8.2.1 

DSR Section 5, Appendix H, 1.4 

Data Structures 5.3 

Enable/Disable Status Change 

Notification HSR Subroutine 5.6.4 

End-of-Record (ENDRCD) Routine 5.7.3 

ENDRCD Routine 5.7.3 

Examples, System 

Generation Appendix F 

Execute System Generation Utility 

(XGEN) Command 3.4, 4.5 

Execute 2.2 to 3.0 Disk Conversion 

(XCU) Command 8.2.2.1 

Expansion Chassis .... 3.4.4.20, 3.4.5.1, F.5 
Extension for Terminals with 

Keyboards (XTK) 5.3.5 

Factor, Interleaving 2.5.2 

FD1000 2.6.3 

File, Patch Appendix J 

Files: 

GEN990 3.3.1 

System 2.11 

Generic Keycap 
Names Appendix A, TA-1 

GEN990 1.3,3.3 

Command Mode 3.3.2.2 

Files 3.3.1 

Inquire Mode 3.3.2.1 

Get Character (G ETC) Routine 5.7.5 

Get System Pointer Table 
Address SVC > 32 7.12 
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GETC Routine 5.7.5 

Global LUNOs TE-1 

Hang 4.3.1 

Hardware Controller Service 

Routine (HSR) 5.5.4 

HSR 5.5.4 

Baud Rate Code T5-10 

Controller Type Code T5-11 

HSR Common Subroutine 5.6 

Controller Interrupt Decoder 5.6.9 

Enable/Disable Status Change 

Notification 5.6.4 

Output a Character 5.6.5 

Power-Up Initialization 5.6.1 

Read Input Signal or Function 5.6.3 

Read Operational Parameters 

and Information 5.6.7 

Request Time Interval Notification . . 5.6.8 

Write Operational Parameters 5.6.6 

Set Channel Speed 

(Baud Rate) 5.6.6.1 

Set Data Character Format . 5.6.6.2 

Write Output Signal or Function 5.6.2 

IGS 3.8 

Initialize Date and Time SVC > 3B 7.13 

Initialize New Volume (INV) 

Command 2.5.2, 4.6 

Initialize New Volume SVC > 38 7.16 

Initialize System (IS) 

Command 2.6.1, 2.13.3 

Inquire Mode, GEN990 3.3.2.1 

Install Disk Volume SVC > 20 7.17 

Install Generated System (IGS) 

Command 3.8 

Install Overlay SVC > 27 7.4 

Install Procedure SVC > 26 7.3 

Install Real-Time Task SVC > 25 7.2.2 

Install Task: 

Special FormSVC>25 7.2.1 

SVC>25 7.2 

Interface Boards T3-9, T3-10 

Interleaving Factor 2.5.2 

Interrupt Service Routine (ISR) 5.2.5 

Asynchronous 5.5.3 

Interrupts 3.2.3, 5.2.5 

INV Command 2.5.2, 4.6 

I/O Call Routine 5.2.1 

IS Command 2.6.1, 2.13.3 

ISR 5.2.5 

Asynchronous 5.5.3 

JMCALL Routine 5.7.6 

Jump Table Call (JMCALL) Routine . . . 5.7.6 

Key Sequences TA-2 

Keyboard Function (KEYFUN) 

Routine 5.7.4 

Keyboard Layout: 

Business System Terminal FA-5 



820 KSR FA-6 

911 VDT FA-1 

915 VDT FA-2 

931 VDT FA-4 

940 EVT FA-3 

Keyboard Status Block (KSB) 5.3.2 

Keycap Name Equivalents, 911 VDT . . . TA-3 
Keycap Names, 

Generic Appendix A, TA-1 

KEYFUN Routine 5.7.4 

Kill Task SVC > 33 .7.8 

KSB 5.3.2 

Log, DX10 2.X Conversion 8.2.2.2 

LUNOs, Global TE-1 

Memory Estimator Appendix I 

Modified SVC, DX10 2.X 8.3.3 

Modify Terminal Status (MTS) 

Command 2.13.2 

Modify Volume Information (MVI) 

Command 2.1 2 

MTS Command 2.13.2 

Multiple Disk, DX10 2.X Conversion . . . 8.2.2 

MVI Command 2.12 

M$00 4.5 

Near Equality Algorithm 3.3.3.2 

Obsolete SVC, DX10 2.X 8.3.1, 8.3.2 

Output a Character HSR Subroutine . . . 5.6.5 
Overlay IDs, System Appendix C 

Patch File Appendix J 

Patch Generated System (PGS) 

Command Appendix J, 3.6, 4.5 

Patching the System, 

System Generation 3.6 

PDT 5.3.1 

PGS Command Appendix J, 3.6, 4.5 

Physical Device Table (PDT) 5.3.1 

Power-Up Initialization HSR 

Subroutine 5.6.1 

Privileged SVC Section 7, 1.6 

Procedure IDs, System TD-1 

Programmer Panel F2-1 

Put Character in Buffer (PUTCBF) 

Routine 5.7.7 

Put Event Character in Buffer (PUTEBF) 

Routine 5.7.8 

PUTCBF Routine 5.7.7 

PUTEBF Routine 5.7.8 

Q$SYN Command 4.5 

Read Input Signal or Function HSR 
Subroutine 5.6.3 

Read Operational Parameters 
and Information HSR Subroutine . . . 5.6.7 

Read/Write Task SVC > 2D 7.1 1 

Read/Write TSBSV0 2C 7.10 
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Request Time Interval Notification 

HSR Subroutine 5.6.8 

Routine, Common 5.7, See also name 

or mnenomic of routine 



Set Channel Speed (Baud Rate) HSR 

Subroutine 

Set Data Character Format HSR 

Subroutine 

Set Interrupt Mask (SETWPS) 

Routine 

SETWPS Routine 

Special Device 3.4, 

Structure, SVC 

Subroutine, HSR Common 

Controller Interrupt Decoder .... 
Enable/Disable Status Change 

Notification 

Output a Character 

Power-Up Initialization 

Read Input Signal or Function . . . 
Read Operational Parameters 

and Information 

Request Time Interval 

Notification 

Write Operational Parameters . . . 
Set Channel Speed 

(Baud Rate) 

Set Data Character Format 

Write Output Signal or Function . 



5.6.6.1 



5.6.6.2 



. . . 5.7.9 
. . . 5.7.9 
5.10, F.4 
. . . 6.2.2 
.... 5.6 
. . . 5.6.9 

. . . 5.6.4 
. . . 5.6.5 
. . . 5.6.1 
. . . 5.6.3 

. . . 5.6.7 



. . 5.6.8 
. . 5.6.6 

5.6.6.1 

5.6.6.2 

. . 5.6.2 

Supervisor Call See SVC 

Suspend Awaiting Queue Input 

SVC>24 7.9 

SVC Section 6, Section 7, 1.5 

Assign Space on Program File, 

>37 7.15 

Call Block 6.2.1 

Codes TG-1 

Compatibility, DX10 2.X 8.3 

Delete Overlay, > 2A 7.7 

Delete Procedure, > 29 7.6 

Delete Task, > 28 7.5 

Disk Manager, > 22 7.14 

Error: 

>05 4.4.1 

>0E 4.4.2 

> 89 4.4.3 

Get System Pointer Table Address, 

>32 7.12 

Initialize Date and Time, > 3B 7.13 

Initialize New Volume, > 38 7.16 

Install Disk Volume, > 20 7.17 

Install Overlay, > 27 7.4 

Install Procedure, > 26 7.3 

Install Real-Time Task, > 25 7.2.2 

Install Task Special Form, > 25 7.2.1 

Install Task, > 25 7 2 

KHI Task, > 33 7 8 

Modified, DX10 2.X 8.3.3 

Obsolete, DX10 2.X 8.3.1, 8.3.2 

Privileged Section 7, 1.6 



Read/Write Task, > 2D 7.11 

Read/Write TSB, > 2C 7.10 

Structure 6.2.2 

Suspend Awaiting Queue Input, 

>24 7.9 

Writing Section 6 

Unload Disk Volume, > 34 7.18 

System: 

Files 2.11 

Logbook 4.2 

Overlay IDs Appendix C 

Procedure IDs TD-1 

Task IDs TB-1 

System Generation Section 3, 1.3 

Assembling and Linking the 

System 3.5 

Examples Appendix F 

Expansion Chassis . . 3.4.4.20, 3.4.5.1, F.5 
Patching the System 3.6 

Tape Build Utility 2.7 

Task IDs, System TB-1 

Task Status Block (TSB) 5.3.4 

Terminal Service Routine (TSR) 5.5.2 

Test Generated System (TGS) 

Command 3.7 

TGS Command 3.7 

TILINE Address 3.2.4 

TSB 5.3.4 

TSR 5.5.2 

Unload Disk Volume SVC > 34 7.1 8 

Utility: 

Disk Build 2.6 

Tape Build 2.7 

Write Operational Parameters 

HSR Subroutine 5.6.6 

Write Output Signal or Function 

HSR Subroutine 5.6.2 

Writing, SVC Section 6 

XCU Command 8.2.2.1 

XGEN Command 3 4 4 5 

XTK 5. 3 ; 5 

2.X Conversion, DX10: 

Disk 8.2 

Disk/Magnetic Tape 8.2!l 

Log „ . 8.2.2.2 

Multiple Disk 822 

820 KSR Keyboard Layout FA-6 

911 VDT: 

Keyboard Layout FA-1 

Keycap Name Equivalents TA-3 

915 VDT Keyboard Layout FA-2 

931 VDT Keyboard Layout FA-4 

940 EVT Keyboard Layout FA-3 

> 05, SVC Error 4 4 1 

> 0E, SVC Error 442 

> 89, SVC Error 443 
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